Ground End of Day Close API

Introduzione

L'API chiusura fine giornata Ground^® consente di riallineare le informazioni di spedizione per il vostro Codice Cliente FedEx Ground e di stampare un Manifesto Ground per il vostro autista. Il Manifesto Ground è generato dopo una chiusura soddisfacente e deve essere stampato prima che le spedizioni Ground siano affidate a FedEx. Un cliente può continuare a effettuare spedizioni Ground anche dopo l'esecuzione di una chiusura.

Dettagli dell'API chiusura fine giornata Ground

L'API consente di caricare in FedEx dati relativi alle spedizioni e generare report manifesto, chiudendo così la relativa spedizione FedEx Ground^® (nazionale negli USA e internazionale).

Funzionalità dell'API chiusura fine giornata Ground

Tutte le spedizioni con il medesimo campo di riferimento possono essere raggruppate e chiuse come un unico set.
La funzionalità di conferma del riferimento identifica il sottogruppo di spedizioni per stampare i report configurati.
La Chiusura di fine giornata in riferimento alla funzionalità di chiusura esegue l'operazione di chiusura per le spedizioni. Queste spedizioni sono associate al campo di riferimento specifico.
Questa API carica nel Codice Cliente FedEx informazioni sulle spedizioni Ground.
La funzionalità Errore di verifica spedizione aperta identifica il livello di gestione dell'errore restituito in una risposta. Potete usarla per analizzare le Spedizioni aperte non confermate contestualmente all'esecuzione della Chiusura di fine giornata.

Come funziona l'API chiusura fine giornata Ground

Di seguito sono riportate alcune delle operazioni gestite con l'API chiusura fine giornata di FedEx Ground:

Richiesta di Chiusura di fine giornata Ground

Avvia lo stadio finale di elaborazione di tutti i dati relativi alla spedizione inoltrati dal cliente per la giornata (orario di chiusura) per le spedizioni FedEx Ground. La risposta restituisce soltanto il Manifesto Ground. Il Manifesto Ground è disponibile soltanto in un formato testo (.txt).

Di seguito sono riportate le informazioni di input chiave associate a questa richiesta:

Data di chiusura
Documento di spedizione/Specifiche dei report
Codice Cliente FedEx
Categoria FedEx Ground (FedEx Ground)

Una risposta soddisfacente chiuderà le spedizioni e genererà i report/documenti specificati.

Richiesta di ristampa dei documenti

Genera i report specificati dall'utente che vengono prodotti al termine dell'operazione di chiusura. Restituisce tutti i report specificati prodotti per una data giornata. Può solo ristampare report risalenti a tre giorni prima.

Di seguito sono riportate le informazioni di input chiave associate a questa richiesta:

Data di chiusura
Opzione di ristampa
Documento di spedizione/Specifiche dei report
Codice Cliente FedEx
Categoria FedEx Ground (FedEx Ground)

Una risposta soddisfacente ristamperà i report/documenti.

Chiusura Ground

L'Operazione di chiusura può essere eseguita più volte nel corso di ogni giornata di spedizione. Non è necessario riaprirla una volta effettuata; è sufficiente ricominciare a spedire. Utilizzare il Servizio chiusura per avviare l'elaborazione della fase finale di tutte le spedizioni trasmesse in giornata (orario di chiusura).

Per informazioni più dettagliate in merito ai servizi offerti da FedEx, vedere la Guida ai Servizi FedEx elettronica.

Report FedEx Ground

Manifesto Ground

Dopo il completamento delle etichette di spedizione FedEx Ground per la giornata attuale, il cliente deve \"chiudere\" quelle FedEx Ground rimanenti, stampare un Manifesto Ground per poi consegnarlo all'autista FedEx o all'impiegato del retail. Questo manifesto elenca l'intera attività FedEx Ground ed è richiesto da FedEx per l'elaborazione.

Il report del Manifesto FedEx Ground può essere stampato o ristampato in qualsiasi momento successivo alla Chiusura di fine giornata o più tardi, in caso si sia verificata più di una chiusura nel corso della giornata. Il report del Manifesto FedEx Ground includerà tutte le spedizioni FedEx Ground generate nelle ultime 24 ore.

Il Manifesto di Ritiro FedEx Ground per i Servizi consolidati FedEx è identico a questo report standard generato per qualsiasi tipo di spedizione FedEx Ground. Il Manifesto di Ritiro FedEx Ground è richiesto dal corriere FedEx Ground per l'affidamento dei colli di spedizione. Fornisce al corriere Fedex Ground un riepilogo dei colli ritirati in un dato giorno oltre alle seguenti informazioni:

Codice cliente del mittente
ID FedEx World del mittente
Lettera di Vettura per tutti i colli
Importo C.O.D. (se applicabile)
Valore dichiarato (se applicabile)
Numero di colli oversize I
Numero di colli oversize II
Numero di colli che necessitano di ulteriore gestione
Numero di colli in consegna residenziale
Numero totale di colli
Numero di conferma del ritiro

Regole aziendali

L'operazione di Chiusura è opzionale ma raccomandata. Può essere necessaria se vi occorre uno dei report generati.
Le spedizioni Fedex Ground possono essere cancellate dopo una Chiusura.
L'indirizzo nell'intestazione del Manifesto è estratto dal primo collo inviato nel giorno specificato.

Ritiro API JSON

Ship EndofDayClose API (1.0.0)

Ground End Of Day Close

Use this endpoint to close the Ground shipments and generate the reports.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.

header Parameters

x-customer-transaction-id	string Example: 624deea6-b709-470c-8c39-4b5511281492 This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply.
content-type required	string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file.
x-locale	string Example: en_US This indicates the combination of language code and country code. Click here to see Locales
authorization required	string Example: Bearer XXX This indicates the authorization token for the input request.

Request Body schema: application/json

One of

FullSchema_GEOD_PUT
MinimumSamplePayload-Put-GroundClose

closeReqType	string Enum: "GCDR" "RGCDR" Specify the close request type to initiate processing of shipment data.For ground close the closeReqType is GCDR and for Reprint EndofDay the applicable value is RGCDR.
accountNumber	object (AccountNumber_2) This is the FedEx Account number. Example: XXX456XXX
groundServiceCategory	string Value: "GROUND" This is to specify FedEx ground category for which the shipment to be submitted for end of the day closing.
closeDate	string Indicates the close date. Example: 2020-05-05
trackingNumber	string Specify the tracking number for reprinting the report.It is only applicable for reprint EndofDay and its not applicable for ground EndofDay close endpoint. Example: 7XX96XX42946
reprintOption	string Enum: "BY_SHIP_DATE" "BY_TRACKING_NUMBER" Specify the reprint option to generate report. Either by close date or a tracking number.It is only applicable for reprint EndofDay and its not applicable for ground EndofDay close endpoint.
closeDocumentSpecification	object (CloseDocumentSpecification) Specifies characteristics of the document to be returned for this request.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

put /ship/v1/endofday/

Sandbox Server

https://apis-sandbox.fedex.com/ship/v1/endofday/

Production Server

https://apis.fedex.com/ship/v1/endofday/

Request samples

Content type

application/json

Example

Copy

Expand all Collapse all

{

"closeReqType": "GCDR",
"accountNumber":
{
- "value": "123456789"
},
"groundServiceCategory": "GROUND",
"closeDate": "2020-05-05",
"trackingNumber": "794967542946",
"reprintOption": "BY_SHIP_DATE",
"closeDocumentSpecification":
{
- "closeDocumentTypes":
  [
  - "OP_950"
  ],
- "op950Detail":
  {
  - "format":
    {
    "topOfPageOffset":
    {
    "value": "0",
    "units": "CM"
    },
    "imageType": "PDF",
    "stockType": "OP_950",
    "locale": "en_US"
    }
  }
}

}

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"output":
{
- "alerts":
  [
  - {
    "code": "SHIP.RECIPIENT.POSTALCITY.MISMATCH",
    "alertType": "NOTE",
    "message": "Recipient Postal-City Mismatch."
    }
  ],
- "closeDocuments":
  [
  - {
    "type": "OP_950",
    "shippingCycle": "1003234523333204",
    "shippingDocumentDisposition": "CONFIRMED",
    "accessReference": null,
    "resolution": 200,
    "copiesToPrint": 1,
    "parts":
    [
    {
    "documentPartSequenceNumber": 1,
    "image": "ICAgICAg.."
    }
    ]
    }
  ]
}

}

Reprint End of the day

Use this endpoint to reprint the closed Ground shipments reports.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.

header Parameters

x-customer-transaction-id	string Example: 624deea6-b709-470c-8c39-4b5511281492 This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply.
content-type required	string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file.
x-locale	string Example: en_US This indicates the combination of language code and country code. Click here to see Locales
authorization required	string Example: Bearer XXX This indicates the authorization token for the input request.

Request Body schema: application/json

One of

FullSchema_Reprint_POST
MinimumSamplePayload-Post-Reprintground

closeReqType	string Enum: "GCDR" "RGCDR" Specify the close request type to initiate processing of shipment data.For ground close the closeReqType is GCDR and for Reprint EndofDay the applicable value is RGCDR.
accountNumber	object (AccountNumber_2) This is the FedEx Account number. Example: XXX456XXX
groundServiceCategory	string Value: "GROUND" This is to specify FedEx ground category for which the shipment to be submitted for end of the day closing.
closeDate	string Indicates the close date. Example: 2020-05-05
trackingNumber	string Specify the tracking number for reprinting the report.It is only applicable for reprint EndofDay and its not applicable for ground EndofDay close endpoint. Example: 7XX96XX42946
reprintOption	string Enum: "BY_SHIP_DATE" "BY_TRACKING_NUMBER" Specify the reprint option to generate report. Either by close date or a tracking number.It is only applicable for reprint EndofDay and its not applicable for ground EndofDay close endpoint.
closeDocumentSpecification	object (CloseDocumentSpecification) Specifies characteristics of the document to be returned for this request.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /ship/v1/endofday/

Sandbox Server

https://apis-sandbox.fedex.com/ship/v1/endofday/

Production Server

https://apis.fedex.com/ship/v1/endofday/

Request samples

Payload

Content type

application/json

Example

Copy

Expand all Collapse all

{

"closeReqType": "GCDR",
"accountNumber":
{
- "value": "123456789"
},
"groundServiceCategory": "GROUND",
"closeDate": "2020-05-05",
"trackingNumber": "794967542946",
"reprintOption": "BY_SHIP_DATE",
"closeDocumentSpecification":
{
- "closeDocumentTypes":
  [
  - "OP_950"
  ],
- "op950Detail":
  {
  - "format":
    {
    "topOfPageOffset":
    {
    "value": "0",
    "units": "CM"
    },
    "imageType": "PDF",
    "stockType": "OP_950",
    "locale": "en_US"
    }
  }
}

}

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"output":
{
- "alerts":
  [
  - {
    "code": "SHIP.RECIPIENT.POSTALCITY.MISMATCH",
    "alertType": "NOTE",
    "message": "Recipient Postal-City Mismatch."
    }
  ],
- "closeDocuments":
  [
  - {
    "type": "OP_950",
    "shippingCycle": "1003234523333204",
    "shippingDocumentDisposition": "CONFIRMED",
    "accessReference": null,
    "resolution": 200,
    "copiesToPrint": 1,
    "parts":
    [
    {
    "documentPartSequenceNumber": 1,
    "image": "ICAgICAg.."
    }
    ]
    }
  ]
}

}

Request
Response

Response

Copy

Developer Portal

Ground End of Day Close API

Introduzione

Dettagli dell'API chiusura fine giornata Ground

Come funziona l'API chiusura fine giornata Ground

Chiusura Ground

Report FedEx Ground

Regole aziendali

Ritiro API JSON

Ship EndofDayClose API (1.0.0)

Ground End Of Day Close

header Parameters

Request Body schema: application/json

Responses

Request samples

Response samples

Reprint End of the day

header Parameters

Request Body schema: application/json

Responses

Request samples

Response samples

Enter your user ID and password to log in