Ground End of Day Close API

บทนำ

API สำหรับการปิดรายการเมื่อสิ้นสุดวันสำหรับ Ground^® ช่วยให้คุณสามารถจัดหมวดหมู่ข้อมูลการจัดส่งสำหรับบัญชีของ FedEx Ground และพิมพ์รายการสินค้าสำหรับการจัดส่งภาคพื้นดินให้แก่พนักงานรับส่งพัสดุได้ โดยรายการสินค้าสำหรับการจัดส่งภาคพื้นดินจะถูกสร้างขึ้นหลังจากปิดรายการสำเร็จ และต้องพิมพ์รายการนี้ก่อนที่พัสดุสำหรับการจัดส่งภาคพื้นดินจะถูกส่งมอบไปยัง FedEx ทั้งนี้ ลูกค้าสามารถจัดส่งพัสดุ Ground ต่อไปได้แม้ว่าการปิดรายการจะได้รับการดำเนินการไปแล้วก็ตาม

รายละเอียดของ API สำหรับการปิดรายการเมื่อสิ้นสุดวันสำหรับการจัดส่งภาคพื้นดิน

API นี้อนุญาตให้คุณอัปโหลดข้อมูลพัสดุไปยัง FedEx และสร้างรายงานรายการสินค้า ซึ่งจะเป็นการปิดรายการจัดส่ง FedEx Ground^® ที่เกี่ยวข้องได้ (ทั้งในและต่างประเทศของสหรัฐฯ)

หน้าที่การทำงานของ API สำหรับการปิดรายการเมื่อสิ้นสุดวันสำหรับการจัดส่งภาคพื้นดิน

พัสดุทั้งหมดที่มีฟิลด์อ้างอิงเดียวกันสามารถจัดเป็นกลุ่มและปิดให้เป็นรายการเดียวกันได้
ฟังก์ชันการยืนยันข้อมูลอ้างอิงจะระบุรายการย่อยของพัสดุ เพื่อพิมพ์รายงานที่กำหนดค่าไว้
การปิดรายการเมื่อสิ้นสุดวันด้วยการกำหนดข้อมูลอ้างอิงสำหรับฟังก์ชันการปิดนั้น จะดำเนินการปิดรายการสำหรับการจัดส่งพัสดุ ซึ่งพัสดุเหล่านี้จะเชื่อมโยงกับฟิลด์อ้างอิงที่ระบุ
API นี้จะอัปโหลดข้อมูลการจัดส่งภาคพื้นดินไปยังบัญชี FedEx
ฟังก์ชันข้อผิดพลาดในการตรวจสอบยืนยันพัสดุที่เปิดอยู่ จะกำหนดระดับของการจัดการข้อผิดพลาดซึ่งจะส่งคืนในการตอบกลับ โดยคุณสามารถใช้ฟังก์ชันนี้เพื่อวิเคราะห์พัสดุที่เปิดอยู่ที่ยังไม่ได้รับการยืนยันในขณะที่ทำการปิดรายการเมื่อสิ้นสุดวันได้

API สำหรับการปิดรายการเมื่อสิ้นสุดวันสำหรับการจัดส่งภาคพื้นดินทำงานอย่างไร

ต่อไปนี้เป็นการดำเนินการบางส่วนภายใต้ API สำหรับการปิดรายการเมื่อสิ้นสุดวันของ FedEx Ground:

คำขอการปิดรายการเมื่อสิ้นสุดวันสำหรับการจัดส่งภาคพื้นดิน

เริ่มต้นประมวลผลข้อมูลการจัดส่งรอบสุดท้ายจากพัสดุทั้งหมดที่ลูกค้าส่งมาในแต่ละวัน (จัดส่งภายในเวลาทำการ) สำหรับการจัดส่งแบบ FedEx Ground ซึ่งการตอบกลับจะส่งคืนเฉพาะรายการสินค้าสำหรับการจัดส่งภาคพื้นดินเท่านั้น และรายการสินค้าสำหรับการจัดส่งภาคพื้นดินสามารถใช้ได้ในรูปแบบข้อความ (.txt) เท่านั้น

ต่อไปนี้คือข้อมูลสำคัญที่เกี่ยวข้องกับคำขอนี้:

วันที่ปิด
เอกสารการจัดส่ง/รายงานข้อมูลจำเพาะ
เลขที่บัญชี FedEx
หมวดหมู่ FedEx Ground (FedEx Ground)

การตอบกลับที่เสร็จสมบูรณ์จะดำเนินการปิดการจัดส่งและสร้างรายงาน/เอกสารที่ระบุ

คำขอพิมพ์เอกสารซ้ำ

สร้างรายงานที่ระบุโดยผู้ใช้ซึ่งจะสร้างขึ้นก็ต่อเมื่อมีการดำเนินการปิดรายการ และส่งคืนรายงานที่ระบุทั้งหมดที่สร้างขึ้นสำหรับวันที่ที่เฉพาะเจาะจง โดยจะสามารถพิมพ์รายงานซ้ำได้ไม่เกินสามวันให้หลังเท่านั้น

ต่อไปนี้คือข้อมูลสำคัญที่เกี่ยวข้องกับคำขอนี้:

วันที่ปิด
ตัวเลือกการพิมพ์ซ้ำ
เอกสารการจัดส่ง/รายงานข้อมูลจำเพาะ
เลขที่บัญชี FedEx
หมวดหมู่ FedEx Ground (FedEx Ground)

การตอบกลับที่เสร็จสมบูรณ์จะทำการพิมพ์รายงาน/เอกสารซ้ำ

การปิดรายการ Ground

คุณสามารถทำการปิดรายการได้หลายครั้งในแต่ละวันที่ทำการจัดส่ง ซึ่งไม่จำเป็นต้องทำการเปิดอีกครั้งหากดำเนินการปิดไปแล้ว และคุณยังสามารถดำเนินการจัดส่งต่อได้ในทันที โดยใช้บริการการปิดรายการในการเริ่มต้นประมวลผลข้อมูลการจัดส่งรอบสุดท้ายจากพัสดุทั้งหมดที่ส่งมาในแต่ละวัน (จัดส่งภายในเวลาทำการ)

สำหรับข้อมูลโดยละเอียดเกี่ยวกับบริการที่เสนอโดย FedEx โปรดดูที่ แนวทางการให้บริการ FedEx

รายงาน FedEx Ground

รายการสินค้าสำหรับการจัดส่งภาคพื้นดิน

หลังจากเสร็จสิ้นกิจกรรมเกี่ยวกับฉลากการจัดส่งของ FedEx Ground สำหรับวันที่ ณ ปัจจุบันแล้วนั้น ลูกค้าจะต้อง \"ปิด\" ฉลาก FedEx Ground ที่รอดำเนินการ และพิมพ์รายการสินค้าของ FedEx Ground แล้วยื่นรายการสินค้านี้ให้กับพนักงานขับรถของ FedEx หรือพนักงานร้านขายปลีก ซึ่งรายการสินค้านี้จะแสดงรายการกิจกรรมการพิมพ์ของ FedEx Ground ทั้งหมด และยังเป็นสิ่งที่ FedEx ต้องการสำหรับการดำเนินการอีกด้วย

รายงานรายการสินค้าของ FedEx Ground สามารถพิมพ์หรือพิมพ์ซ้ำได้ทุกเมื่อในทันทีหลังจากการปิดรายการเมื่อสิ้นสุดวัน หรือในภายหลังหากมีการปิดมากกว่าหนึ่งรายการในแต่ละวัน โดยรายงานรายการสินค้าของ FedEx Ground จะรวมการจัดส่งแบบ FedEx Ground ทั้งหมดที่สร้างขึ้นในช่วง 24 ชั่วโมงที่ผ่านมาเอาไว้

รายการรับพัสดุของ FedEx Ground สำหรับบริการโดยรวมของ FedEx จะเหมือนกับรายงานมาตรฐานที่สร้างขึ้นสำหรับการจัดส่งพัสดุแบบ FedEx Ground ทุกประเภท ซึ่งผู้รับส่งพัสดุของ FedEx Ground จำเป็นต้องใช้รายการรับพัสดุของ FedEx Ground ในการส่งมอบพัสดุสำหรับการจัดส่ง โดยจะให้ข้อมูลสรุปเกี่ยวกับพัสดุที่รับในวันที่กำหนดแก่ผู้รับส่งพัสดุของ FedEx Ground และให้ข้อมูลดังต่อไปนี้:

เลขที่บัญชีของผู้ส่ง
หมายเลข Meter ของผู้ส่ง
หมายเลขการติดตามสำหรับพัสดุทั้งหมด
จำนวนเงิน C.O.D. (หากมี)
มูลค่าที่สำแดง (หากมี)
จำนวนพัสดุขนาดใหญ่พิเศษ I
จำนวนพัสดุขนาดใหญ่พิเศษ II
จำนวนพัสดุที่ต้องการการจัดการเพิ่มเติม
จำนวนพัสดุที่จัดส่งในพื้นที่พักอาศัย
จำนวนพัสดุทั้งหมด
หมายเลขยืนยันการรับพัสดุ

กฎการดำเนินธุรกิจ

การปิดรายการสามารถเลือกที่จะดำเนินการหรือไม่ก็ได้ แต่ขอแนะนำให้ดำเนินการ เพราะอาจเป็นสิ่งจำเป็น หากคุณต้องการที่จะสร้างรายงานใดๆ ขึ้นมาก็ตาม
การจัดส่งพัสดุแบบ FedEx Ground สามารถลบได้หลังจากมีการปิดรายการแล้ว
ที่อยู่ในส่วนหัวของรายการสินค้าจะถูกนำมาจากพัสดุชิ้นแรกที่จัดส่งตามวันที่ระบุ

คอลเล็กชัน JSON API

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

บทนำ

รายละเอียดของ API สำหรับการปิดรายการเมื่อสิ้นสุดวันสำหรับการจัดส่งภาคพื้นดิน

API สำหรับการปิดรายการเมื่อสิ้นสุดวันสำหรับการจัดส่งภาคพื้นดินทำงานอย่างไร

การปิดรายการ Ground

รายงาน FedEx Ground

กฎการดำเนินธุรกิจ

คอลเล็กชัน JSON API

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