Sign in

v1

latestOpenAPI 3.0.12026-07-2481208369.3 KB
return-label-generation

Retrieve a previously generated returns label. This call is the metadata about the label, the images of the labels must be asked for specifically in the call, or directly using the `getReturnsLabelImageV1` call.

get/api/v1/deliveryexperience/customerreturn/label/{shipiumCustomerReturnLabelId}

Path parameters

shipiumCustomerReturnLabelIdstring required

Query parameters

includeLabelImagesInResponseboolean required

Response

Label previously generated for the return.

shipiumShipmentIdstring

The unique identifier for the shipment attached to this label.

carrierSelectionIdstring

Unique id of the carrier selection for later lookup.

shipiumCustomerReturnLabelIdstring

The unique identifier for this customer return.

status'success' | 'failure' | 'voided' | 'failover' | 'generated' | 'imported' | 'label_created' | 'manifesting' | 'manifested' | 'manifest_failure' | 'not_set' | 'carrier_selection_failure'

Defines the result of the carrier label call. Values returned will be success, partial, and failed

statusDetailsstring

Details explaining the result status. Pertinent when the status is "partial" or "failed".

carrierstring

The carrier that was used for the return.

carrierServiceNamestring

Name of the carrier service method selected.

serviceMethodNamestring

Name of the service method the label was generated for.

carrierServiceMethodIdstring

Maps to the unique internal Shipium ID which represents a carrier service method definition.

carrierShipmentIdstring

Carrier's identification for the return.

carrierTrackingIdstring

Carrier's tracking identification for the return.

shipiumTrackingIdstring

Shipium's tracking identification for the return.

packageScannableIdstring

Identifier provided that matches the scannable barcode on the label

referenceIdentifierstring

String passed to carriers as a reference.

referenceIdentifier2string

String passed to carriers as a reference2.

referenceIdentifier3string

String passed to carriers as a reference3.

referenceIdentifier4string

String passed to carriers as a reference4.

referenceIdentifier5string

String passed to carriers as a reference5.

partnerReferenceIdentifierstring

Partner custom reference to a return label.

partnerReferenceIdentifier2string

Partner custom reference to a return label.

testModeboolean

A flag denoting whether the label is a test label

labelCreationDateTimestring date-time

The timestamp that the label object was created. This is used primarily for explaining future dated shipments.

Example response

{
  "params": {
    "customsInfo": {
      "totalCustomsValue": 12.34,
      "totalCustomsValueCurrency": "usd",
      "customsDescription": "9 mm steel screws",
      "reasonForExport": "sale",
      "businessIndicator": "B2C",
      "invoiceDate": "1970-01-01",
      "invoiceNumber": "abcde-f12345-67890-abcdef",
      "europeanUnionInfo": {
        "vendorIossAddress": {
          "name": "Wile E. Coyote",
          "phoneNumberCountryCode": "+2",
          "company": "ACME",
          "street1": "123 Main St.",
          "street2": "Suite 42",
          "city": "Albuquerque",
          "state": "NM",
          "countryCode": "US",
          "postalCode": "\"87121\"",
          "addressType": "commercial",
          "addressLineComponents": {
            "streetName": "U.H. Fovisste Fuentes Brotantes",
            "primaryAddressNumber": "12",
            "secondaryAddressNumber": "302",
            "district": "Iztacalco",
            "neighborhood": "Agrícola Pantitlán"
          }
        }
      },
      "ultimateConsigneeAddress": {
        "name": "Wile E. Coyote",
        "phoneNumberCountryCode": "+2",
        "company": "ACME",
        "street1": "123 Main St.",
        "street2": "Suite 42",
        "city": "Albuquerque",
        "state": "NM",
        "countryCode": "US",
        "postalCode": "\"87121\"",
        "addressType": "commercial",
        "addressLineComponents": {
          "streetName": "U.H. Fovisste Fuentes Brotantes",
          "primaryAddressNumber": "12",
          "secondaryAddressNumber": "302",
          "district": "Iztacalco",
          "neighborhood": "Agrícola Pantitlán"
        }
      },
      "ultimateConsigneeType": "DIRECT_CONSUMER",
      "permitNumber": "12345",
      "customsItems": [
        {
          "customsValue": 12.34,
          "customsValueCurrency": "usd",
          "commodityDescription": "baby socks",
          "countryOfManufacture": "CN",
          "customsWeight": {
            "weightUnit": "lb",
            "weight": 50
          },
          "quantity": 3,
          "productId": "RN03947--Z43121",
          "standardizedProductIds": [
            {
              "type": "GTIN",
              "value": "0012345678905"
            }
          ],
          "manufacturerProductId": "MPN-77B-XL",
          "electronicExportCommodityInformation": {
            "exportType": "domestic",
            "exportInformationCode": "LC",
            "scheduleBInformation": {
              "scheduleBNumber": "6404195500"
            },
            "eccnNumber": "EAR99",
            "exportLicenseInformation": {
              "licenseType": "C33",
              "licenseExemptionCode": "NLR"
            }
          },
          "cpscCertificateOfCompliance": {
            "manufacturerAddress": {
              "name": "Wile E. Coyote",
              "phoneNumberCountryCode": "+2",
              "company": "ACME",
              "street1": "123 Main St.",
              "street2": "Suite 42",
              "city": "Albuquerque",
              "state": "NM",
              "countryCode": "US",
              "postalCode": "\"87121\"",
              "addressType": "commercial",
              "addressLineComponents": {
                "streetName": "U.H. Fovisste Fuentes Brotantes",
                "primaryAddressNumber": "12",
                "secondaryAddressNumber": "302",
                "district": "Iztacalco",
                "neighborhood": "Agrícola Pantitlán"
              }
            },
            "testingLabAddress": {
              "name": "Wile E. Coyote",
              "phoneNumberCountryCode": "+2",
              "company": "ACME",
              "street1": "123 Main St.",
              "street2": "Suite 42",
              "city": "Albuquerque",
              "state": "NM",
              "countryCode": "US",
              "postalCode": "\"87121\"",
              "addressType": "commercial",
              "addressLineComponents": {
                "streetName": "U.H. Fovisste Fuentes Brotantes",
                "primaryAddressNumber": "12",
                "secondaryAddressNumber": "302",
                "district": "Iztacalco",
                "neighborhood": "Agrícola Pantitlán"
              }
            }
          }
        }
      ],
      "incoterm": "DDP",
      "taxIdentificationNumber": "12345",
      "importerOfRecord": {
        "importerAddress": {
          "name": "Wile E. Coyote",
          "phoneNumberCountryCode": "+2",
          "company": "ACME",
          "street1": "123 Main St.",
          "street2": "Suite 42",
          "city": "Albuquerque",
          "state": "NM",
          "countryCode": "US",
          "postalCode": "\"87121\"",
          "addressType": "commercial",
          "addressLineComponents": {
            "streetName": "U.H. Fovisste Fuentes Brotantes",
            "primaryAddressNumber": "12",
            "secondaryAddressNumber": "302",
            "district": "Iztacalco",
            "neighborhood": "Agrícola Pantitlán"
          }
        },
        "taxIdentificationNumbers": [
          {
            "number": "12345"
          }
        ]
      },
      "brokers": [
        {
          "brokerAddress": {
            "name": "Wile E. Coyote",
            "phoneNumberCountryCode": "+2",
            "company": "ACME",
            "street1": "123 Main St.",
            "street2": "Suite 42",
            "city": "Albuquerque",
            "state": "NM",
            "countryCode": "US",
            "postalCode": "\"87121\"",
            "addressType": "commercial",
            "addressLineComponents": {
              "streetName": "U.H. Fovisste Fuentes Brotantes",
              "primaryAddressNumber": "12",
              "secondaryAddressNumber": "302",
              "district": "Iztacalco",
              "neighborhood": "Agrícola Pantitlán"
            }
          },
          "taxIdentificationNumbers": [
            {
              "number": "12345"
            }
          ]
        }
      ],
      "soldTo": {
        "address": {
          "name": "Wile E. Coyote",
          "phoneNumberCountryCode": "+2",
          "company": "ACME",
          "street1": "123 Main St.",
          "street2": "Suite 42",
          "city": "Albuquerque",
          "state": "NM",
          "countryCode": "US",
          "postalCode": "\"87121\"",
          "addressType": "commercial",
          "addressLineComponents": {
            "streetName": "U.H. Fovisste Fuentes Brotantes",
            "primaryAddressNumber": "12",
            "secondaryAddressNumber": "302",
            "district": "Iztacalco",
            "neighborhood": "Agrícola Pantitlán"
          }
        },
        "taxIdentificationNumbers": [
          {
            "number": "12345"
          }
        ]
      }
    }
  },
  "internationalDocuments": [
    {
      "documentType": "commercial_invoice",
      "documentImage": {
        "documentEncoding": "base64"
      },
      "electronicallySubmitted": true
    }
  ],
  "hazardousMaterialsDocuments": [
    {
      "documentType": "commercial_invoice",
      "documentImage": {
        "documentEncoding": "base64"
      },
      "electronicallySubmitted": true
    }
  ]
}