Ground End of Day Close API

Giới thiệu

API Chốt sổ cuối ngày của dịch vụ Ground^® cho phép bạn đối chiếu thông tin vận chuyển cho tài khoản FedEx Ground của mình và in bản kê khai vận chuyển đường bộ cho tài xế. Bản kê khai vận chuyển đường bộ được tạo sau khi chốt sổ thành công và phải được in trước khi các lô hàng đường bộ được gửi cho FedEx. Khách hàng có thể tiếp tục vận chuyển các gói hàng đường bộ ngay cả khi đã chốt sổ.

Chi tiết về API Chốt sổ cuối ngày của dịch vụ Ground

API này cho phép bạn tải dữ liệu gói lên FedEx và tạo báo cáo kê khai, từ đó đóng lô hàng FedEx Ground tương ứng^® (Lô hàng nội địa Hoa Kỳ và quốc tế).

Chức năng của API Chốt sổ cuối ngày của dịch vụ Ground:

Tất cả các lô hàng có cùng trường tham chiếu có thể được nhóm lại và chốt lại thành một bộ.
Chức năng xác nhận tham chiếu sẽ xác định tập hợp con các lô hàng để in các báo cáo theo cấu hình.
Chốt sổ cuối ngày với chỉ định tham chiếu cho chức năng chốt sổ thực hiện hoạt động chốt sổ cho các lô hàng. Các lô hàng này được liên kết với trường tham chiếu được chỉ định.
API này tải thông tin lô hàng đường bộ lên tài khoản FedEx.
Chức năng Lỗi xác minh lô hàng mở sẽ chỉ định mức độ xử lý lỗi được trả về trong phần trả lời. Bạn có thể sử dụng chức năng này để phân tích các Lô hàng mở chưa được xác nhận khi thực hiện giao dịch Chốt sổ cuối ngày.

Cách thức hoạt động của API Chốt sổ cuối ngày của dịch vụ Ground

Sau đây là một số hoạt động trong API Chốt sổ cuối ngày của FedEx Ground:

Yêu cầu chốt sổ cuối ngày của dịch vụ Ground

Bắt đầu giai đoạn cuối cùng để xử lý tất cả dữ liệu lô hàng do khách hàng gửi trong ngày (cuối ngày làm việc) cho các lô hàng FedEx Ground. Phản hồi chỉ trả về Bản kê khai vận chuyển đường bộ. Bản kê khai vận chuyển đường bộ chỉ có ở định dạng văn bản (.txt).

Sau đây là các thông tin đầu vào quan trọng liên kết với yêu cầu này:

Ngày chốt sổ
Thông số kỹ thuật về báo cáo/chứng từ vận chuyển
Số tài khoản FedEx
Danh mục FedEx Ground (FedEx Ground)

Phản hồi thành công sẽ chốt sổ các lô hàng và tạo ra các báo cáo/chứng từ được chỉ định.

Yêu cầu In lại chứng từ

Tạo báo cáo do người dùng chỉ định tạo khi thao tác Chốt sổ được xử lý. Trả về mọi báo cáo được chỉ định đã tạo cho một ngày cụ thể. Tính năng này chỉ có thể in lại báo cáo đã qua không quá ba ngày.

Sau đây là các thông tin đầu vào quan trọng liên kết với yêu cầu này:

Ngày chốt sổ
Tùy chọn in lại
Thông số kỹ thuật về báo cáo/chứng từ vận chuyển
Số tài khoản FedEx
Danh mục FedEx Ground (FedEx Ground)

Phản hồi thành công sẽ in lại các báo cáo/chứng từ.

Chốt sổ dịch vụ Ground

Hoạt động chốt sổ có thể được thực hiện nhiều lần trong mỗi ngày vận chuyển. Bạn không cần mở lại sau khi quá trình chốt sổ đã được xử lý mà có thể tiếp tục vận chuyển. Sử dụng Dịch vụ chốt sổ để bắt đầu giai đoạn cuối cùng để xử lý tất cả dữ liệu lô hàng được gửi trong ngày (cuối ngày làm việc).

Để biết thêm thông tin chi tiết về các dịch vụ do FedEx cung cấp, hãy xem trang điện tử của Hướng dẫn dịch vụ FedEx.

Báo cáo FedEx Ground

Bản kê khai dịch vụ Ground

Sau khi hoàn thành hoạt động dán nhãn vận chuyển FedEx Ground cho ngày hiện tại, khách hàng phải \"chốt sổ\" các nhãn FedEx Ground đang chờ xử lý và in Bản kê khai FedEx Ground, rồi gửi bản kê khai này cho tài xế hoặc nhân viên bán lẻ của FedEx. Bản kê khai này liệt kê tất cả hoạt động in của FedEx Ground và được FedEx yêu cầu cho việc xử lý.

Bản kê khai FedEx Ground có thể được in hoặc in lại bất kỳ lúc nào ngay sau khi Chốt sổ cuối ngày hoặc muộn hơn, nếu có nhiều hơn một lần chốt sổ trong ngày. Bản kê khai FedEx Ground sẽ bao gồm tất cả các lô hàng FedEx Ground được tạo trong 24 giờ qua.

Bản kê khai lấy hàng FedEx Ground cho Dịch vụ gom hàng của FedEx giống với báo cáo tiêu chuẩn được tạo cho mọi loại hình vận chuyển gói hàng FedEx Ground. Hãng chuyển phát cần có Bản kê khai lấy hàng FedEx Ground để vận chuyển các gói hàng. Bản kê khai này tóm tắt về các gói hàng được lấy vào một ngày nhất định cho hãng chuyển phát FedEx Ground và cung cấp thông tin sau:

Số tài khoản của người gửi
Số trên dụng cụ đo của người gửi
Số theo dõi cho tất cả các gói hàng
Khoản tiền áp dụng thu tiền khi giao hàng (nếu có)
Giá trị đã khai báo (nếu có)
Số lượng gói hàng Quá khổ I
Số lượng gói hàng Quá khổ II
Số lượng gói hàng yêu cầu xử lý bổ sung
Số lượng gói hàng giao đến nơi cư trú
Tổng số gói hàng
Số xác nhận nhận hàng

Quy tắc kinh doanh

Hoạt động Chốt sổ là không bắt buộc nhưng nên thực hiện. Bạn có thể cần thực hiện hoạt động này nếu cần bất kỳ báo cáo nào được tạo.
Các lô hàng FedEx Ground có thể xóa sau khi Chốt sổ.
Địa chỉ trong tiêu đề bản kê khai được trích xuất từ gói hàng đầu tiên được vận chuyển vào ngày đó.

Bộ sưu tập 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

Giới thiệu

Chi tiết về API Chốt sổ cuối ngày của dịch vụ Ground

Cách thức hoạt động của API Chốt sổ cuối ngày của dịch vụ Ground

Chốt sổ dịch vụ Ground

Báo cáo FedEx Ground

Quy tắc kinh doanh

Bộ sưu tập 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