UPS Paperless Document Virtual Sandbox

Upload and manage international shipping trade documents for paperless processing.

The UPS Paperless Documents API enables the digital submission of trade documents such as commercial invoices, certificates of origin, and export licenses. It supports uploading document files and images, as well as deleting previously uploaded records to streamline international shipping workflows.

Use this hosted sandbox to simulate UPS Paperless Document APIs without authentication, API keys, or extra dependencies. Point your code or SDK to the Beeceptor base URL, preferably through an environment variable or feature flag, and switch back to the production API when ready. This keeps your integration code consistent across local development, QA, demos, and production.

Use cases:

Use this sandbox to validate document upload payloads, verify file format handling, test document type mapping, and simulate error responses for invalid document metadata before integrating with UPS production shipping systems.

UPS Paperless Document virtual sandbox is up and running!

Use this sandbox URL as the API base in your code to simulate UPS Paperless Document responses instantly.

`https://ups-paperless-docs.mock.beeceptor.com`

Paperless(6 operations)

POST

/paperlessdocuments/{version}/upload

The Paperless Document API web service allows the users to upload,delete and push to image repository their own customized trade documents for customs clearance to Forms History.

Header Name	Example
`transId`	`"qui"`
`transactionSrc`	`"adipisicing"`
`ShipperNumber`*	`"do elit"`

Request Payload

{
  "UploadRequest": {
    "Request": {
      "TransactionReference": {
        "CustomerContext": ""
      }
    },
    "UserCreatedForm": {
      "UserCreatedFormFileName": "TestFile.txt",
      "UserCreatedFormFileFormat": "txt",
      "UserCreatedFormDocumentType": "013",
      "UserCreatedFormFile": "Tm90aWNlDQpJbiBhbGwgY29tbXVuaWNhdGlvbnMgd2l0aCBVUFMgY29uY2VybmluZyB0aGlzIGRvY3VtZW50LCBwbGVhc2UgcmVmZXIgdG8gdGhlIGRvY3VtZW50IGRhdGUgbG9jYXRlZCBvbiB0aGUgY292ZXIuDQpDb3B5cmlnaHQNClRoZSB1c2UsIGRpc2Nsb3N1cmUsIHJlcHJvZHVjdGlvbiwgbW9kaWZpY2F0aW9uLCB0cmFuc2Zlciwgb3IgdHJhbnNtaXR0YWwgb2YgdGhpcyB3b3JrIGZvciBhbnkgcHVycG9zZSBpbiBhbnkgZm9ybSBvciBieSBhbnkgbWVhbnMgd2l0aG91dCB0aGUgd3JpdHRlbiBwZXJtaXNzaW9uIG9mIFVuaXRlZCBQYXJjZWwgU2VydmljZSBpcyBzdHJpY3RseSBwcm9oaWJpdGVkLg0KwqkgQ29weXJpZ2h0IDIwMTYgVW5pdGVkIFBhcmNlbCBTZXJ2aWNlIG9mIEFtZXJpY2EsIEluYy4gQWxsIFJpZ2h0cyBSZXNlcnZlZC4NClRyYWRlbWFya3MNClVQUyBPbkxpbmXCriBpcyBhIHJlZ2lzdGVyZWQgdHJhZGVtYXJrIG9mIFVuaXRlZCBQYXJjZWwgU2VydmljZSBvZiBBbWVyaWNhLCBJbmMuIEFsbCBvdGhlciB0cmFkZW1hcmtzIGFyZSB0aGUgcHJvcGVydHkgb2YgdGhlaXIgcmVzcGVjdGl2ZSBvd25lcnMuDQpTb21lIG9mIHRoZSBVUFMgY29ycG9yYXRlIGFwcGxpY2F0aW9ucyB1c2UgVS5TLiBjaXR5LCBzdGF0ZSwgYW5kIHBvc3RhbCBjb2RlIGluZm9ybWF0aW9uIG9idGFpbmVkIGJ5IFVuaXRlZCBQYXJjZWwgU2VydmljZSBvZiBBbWVyaWNhLCBJbmMuIHVuZGVyIGEgbm9uLWV4Y2x1c2l2ZSBsaWNlbnNlIGZyb20gdGhlIFVuaXRlZCBTdGF0ZXMgUG9zdGFsIFNlcnZpY2UuIA0K"
    }
  }
}

Response Payload

{
  "UploadResponse": {
    "FormsHistoryDocumentID": {
      "DocumentID": [
        "doc-002",
        "doc-001"
      ]
    },
    "Response": {
      "Alert": [
        {
          "Code": "8",
          "Description": "Document already exists"
        },
        {
          "Code": "8",
          "Description": "Invalid document ID"
        }
      ],
      "ResponseStatus": {
        "Code": "1",
        "Description": "Failure"
      },
      "TransactionReference": {
        "CustomerContext": "bb9283d2-271e-4dce-be7f-b35021d7b7af"
      }
    }
  }
}

{
  "response": {
    "errors": [
      {
        "code": "6",
        "message": "Not found"
      },
      {
        "code": "2",
        "message": "Internal server error"
      },
      {
        "code": "3",
        "message": "Unauthorized"
      },
      {
        "code": "5",
        "message": "Internal server error"
      },
      {
        "code": "4",
        "message": "Not found"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "4",
        "message": "Not found"
      },
      {
        "code": "2",
        "message": "Invalid request"
      },
      {
        "code": "3",
        "message": "Unauthorized"
      },
      {
        "code": "9",
        "message": "Invalid request"
      },
      {
        "code": "2",
        "message": "Unauthorized"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "9",
        "message": "Not found"
      },
      {
        "code": "2",
        "message": "Internal server error"
      },
      {
        "code": "3",
        "message": "Invalid request"
      },
      {
        "code": "6",
        "message": "Not found"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "5",
        "message": "Invalid request"
      },
      {
        "code": "1",
        "message": "Internal server error"
      },
      {
        "code": "3",
        "message": "Invalid request"
      },
      {
        "code": "3",
        "message": "Not found"
      },
      {
        "code": "1",
        "message": "Invalid request"
      }
    ]
  }
}

POST

/paperlessdocuments/{version}/image

The Paperless Document API web service allows the users to upload their own customized trade documents for customs clearance to Forms History.

Header Name	Example
`transId`	`"ea"`
`transactionSrc`	`"culpa labore commodo"`
`ShipperNumber`*	`"labore magna"`

Request Payload

{
  "PushToImageRepositoryRequest": {
    "Request": {
      "TransactionReference": {
        "CustomerContext": "Your Customer Context"
      }
    },
    "FormsHistoryDocumentID": {
      "DocumentID": "2016-01-18-11.01.07.589501"
    },
    "ShipmentIdentifier": "Your Package Shipment Identifier",
    "ShipmentDateAndTime": "2016-01-18-11.01.07",
    "ShipmentType": "1",
    "TrackingNumber": "Your Package Tracking Number"
  }
}

Response Payload

{
  "PushToImageRepositoryResponse": {
    "FormsGroupID": "ed4bc943-8e62-4d4c-8e8a-e5",
    "Response": {
      "Alert": [
        {
          "Code": "5",
          "Description": "Document already exists"
        },
        {
          "Code": "5",
          "Description": "Document already exists"
        },
        {
          "Code": "9",
          "Description": "System timeout"
        },
        {
          "Code": "3",
          "Description": "Invalid document ID"
        },
        {
          "Code": "5",
          "Description": "Permission denied"
        }
      ],
      "ResponseStatus": {
        "Code": "0",
        "Description": "Failure"
      },
      "TransactionReference": {
        "CustomerContext": "33caa3c8-f17f-467c-be15-e801da1774b5"
      }
    }
  }
}

{
  "response": {
    "errors": [
      {
        "code": "1",
        "message": "Not found"
      },
      {
        "code": "1",
        "message": "Invalid request"
      },
      {
        "code": "1",
        "message": "Unauthorized"
      },
      {
        "code": "5",
        "message": "Unauthorized"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "3",
        "message": "Internal server error"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "8",
        "message": "Invalid request"
      },
      {
        "code": "8",
        "message": "Invalid request"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "3",
        "message": "Unauthorized"
      },
      {
        "code": "2",
        "message": "Invalid request"
      },
      {
        "code": "6",
        "message": "Invalid request"
      }
    ]
  }
}

DELETE

/paperlessdocuments/{version}/DocumentId/ShipperNumber

The Paperless Document API web service allows the users to upload their own customized trade documents for customs clearance to Forms History.

Header Name	Example
`transId`	`"proident ut qui minim"`
`transactionSrc`	`"ea mollit nulla minim"`
`ShipperNumber`*	`"anim qui"`
`DocumentId`*	`"irure do"`

Request Payload

Response Payload

{
  "DeleteResponse": {
    "Response": {
      "Alert": [
        {
          "Code": "5",
          "Description": "Invalid document ID"
        },
        {
          "Code": "9",
          "Description": "System timeout"
        },
        {
          "Code": "8",
          "Description": "Invalid document ID"
        },
        {
          "Code": "6",
          "Description": "Invalid document ID"
        }
      ],
      "ResponseStatus": {
        "Code": "0",
        "Description": "Success"
      },
      "TransactionReference": {
        "CustomerContext": "53d55cd4-58c2-4f54-93bb-d0bd91cc8442"
      }
    }
  }
}

{
  "response": {
    "errors": [
      {
        "code": "7",
        "message": "Internal server error"
      },
      {
        "code": "3",
        "message": "Not found"
      },
      {
        "code": "4",
        "message": "Unauthorized"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "8",
        "message": "Not found"
      },
      {
        "code": "4",
        "message": "Not found"
      },
      {
        "code": "7",
        "message": "Internal server error"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "7",
        "message": "Unauthorized"
      },
      {
        "code": "4",
        "message": "Internal server error"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "2",
        "message": "Not found"
      },
      {
        "code": "8",
        "message": "Not found"
      },
      {
        "code": "7",
        "message": "Invalid request"
      },
      {
        "code": "0",
        "message": "Internal server error"
      }
    ]
  }
}

POST

/paperlessdocuments/{deprecatedVersion}/upload

The Paperless Document API web service allows the users to upload,delete and push to image repository their own customized trade documents for customs clearance to Forms History.

Header Name	Example
`transId`	`"commodo in proident dolore esse"`
`transactionSrc`	`"officia"`
`ShipperNumber`*	`"cillum esse labore in"`

Request Payload

{
  "UploadRequest": {
    "Request": {
      "TransactionReference": {
        "CustomerContext": ""
      }
    },
    "UserCreatedForm": {
      "UserCreatedFormFileName": "TestFile.txt",
      "UserCreatedFormFileFormat": "txt",
      "UserCreatedFormDocumentType": "013",
      "UserCreatedFormFile": "Tm90aWNlDQpJbiBhbGwgY29tbXVuaWNhdGlvbnMgd2l0aCBVUFMgY29uY2VybmluZyB0aGlzIGRvY3VtZW50LCBwbGVhc2UgcmVmZXIgdG8gdGhlIGRvY3VtZW50IGRhdGUgbG9jYXRlZCBvbiB0aGUgY292ZXIuDQpDb3B5cmlnaHQNClRoZSB1c2UsIGRpc2Nsb3N1cmUsIHJlcHJvZHVjdGlvbiwgbW9kaWZpY2F0aW9uLCB0cmFuc2Zlciwgb3IgdHJhbnNtaXR0YWwgb2YgdGhpcyB3b3JrIGZvciBhbnkgcHVycG9zZSBpbiBhbnkgZm9ybSBvciBieSBhbnkgbWVhbnMgd2l0aG91dCB0aGUgd3JpdHRlbiBwZXJtaXNzaW9uIG9mIFVuaXRlZCBQYXJjZWwgU2VydmljZSBpcyBzdHJpY3RseSBwcm9oaWJpdGVkLg0KwqkgQ29weXJpZ2h0IDIwMTYgVW5pdGVkIFBhcmNlbCBTZXJ2aWNlIG9mIEFtZXJpY2EsIEluYy4gQWxsIFJpZ2h0cyBSZXNlcnZlZC4NClRyYWRlbWFya3MNClVQUyBPbkxpbmXCriBpcyBhIHJlZ2lzdGVyZWQgdHJhZGVtYXJrIG9mIFVuaXRlZCBQYXJjZWwgU2VydmljZSBvZiBBbWVyaWNhLCBJbmMuIEFsbCBvdGhlciB0cmFkZW1hcmtzIGFyZSB0aGUgcHJvcGVydHkgb2YgdGhlaXIgcmVzcGVjdGl2ZSBvd25lcnMuDQpTb21lIG9mIHRoZSBVUFMgY29ycG9yYXRlIGFwcGxpY2F0aW9ucyB1c2UgVS5TLiBjaXR5LCBzdGF0ZSwgYW5kIHBvc3RhbCBjb2RlIGluZm9ybWF0aW9uIG9idGFpbmVkIGJ5IFVuaXRlZCBQYXJjZWwgU2VydmljZSBvZiBBbWVyaWNhLCBJbmMuIHVuZGVyIGEgbm9uLWV4Y2x1c2l2ZSBsaWNlbnNlIGZyb20gdGhlIFVuaXRlZCBTdGF0ZXMgUG9zdGFsIFNlcnZpY2UuIA0K"
    }
  }
}

Response Payload

{
  "UploadResponse": {
    "FormsHistoryDocumentID": {
      "DocumentID": [
        "doc-002",
        "doc-001"
      ]
    },
    "Response": {
      "Alert": [
        {
          "Code": "4",
          "Description": "Document already exists"
        },
        {
          "Code": "4",
          "Description": "Permission denied"
        },
        {
          "Code": "4",
          "Description": "Document already exists"
        },
        {
          "Code": "3",
          "Description": "Invalid document ID"
        }
      ],
      "ResponseStatus": {
        "Code": "1",
        "Description": "Success"
      },
      "TransactionReference": {
        "CustomerContext": "319e9c9b-42d8-4506-a1d7-d7a485fc0e67"
      }
    }
  }
}

{
  "response": {
    "errors": [
      {
        "code": "0",
        "message": "Unauthorized"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "7",
        "message": "Invalid request"
      },
      {
        "code": "5",
        "message": "Unauthorized"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "4",
        "message": "Invalid request"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "6",
        "message": "Not found"
      }
    ]
  }
}

POST

/paperlessdocuments/{deprecatedVersion}/image

The Paperless Document API web service allows the users to upload their own customized trade documents for customs clearance to Forms History.

Header Name	Example
`transId`	`"ut Ut"`
`transactionSrc`	`"et"`
`ShipperNumber`*	`"in fugiat laboris"`

Request Payload

{
  "PushToImageRepositoryRequest": {
    "Request": {
      "TransactionReference": {
        "CustomerContext": "Your Customer Context"
      }
    },
    "FormsHistoryDocumentID": {
      "DocumentID": "2016-01-18-11.01.07.589501"
    },
    "ShipmentIdentifier": "Your Package Shipment Identifier",
    "ShipmentDateAndTime": "2016-01-18-11.01.07",
    "ShipmentType": "1",
    "TrackingNumber": "Your Package Tracking Number"
  }
}

Response Payload

{
  "PushToImageRepositoryResponse": {
    "FormsGroupID": "f66e48b3-281f-4ba5-9f75-02",
    "Response": {
      "Alert": [
        {
          "Code": "1",
          "Description": "Permission denied"
        },
        {
          "Code": "8",
          "Description": "System timeout"
        },
        {
          "Code": "5",
          "Description": "Document already exists"
        },
        {
          "Code": "3",
          "Description": "Permission denied"
        }
      ],
      "ResponseStatus": {
        "Code": "1",
        "Description": "Success"
      },
      "TransactionReference": {
        "CustomerContext": "d18a5d09-4df1-4847-93c3-199963ba1fca"
      }
    }
  }
}

{
  "response": {
    "errors": [
      {
        "code": "7",
        "message": "Unauthorized"
      },
      {
        "code": "2",
        "message": "Unauthorized"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "7",
        "message": "Not found"
      },
      {
        "code": "4",
        "message": "Internal server error"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "8",
        "message": "Internal server error"
      },
      {
        "code": "1",
        "message": "Internal server error"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "1",
        "message": "Not found"
      },
      {
        "code": "0",
        "message": "Unauthorized"
      }
    ]
  }
}

DELETE

/paperlessdocuments/{deprecatedVersion}/DocumentId/ShipperNumber

The Paperless Document API web service allows the users to upload their own customized trade documents for customs clearance to Forms History.

Header Name	Example
`transId`	`"laborum"`
`transactionSrc`	`"dolor"`
`ShipperNumber`*	`"commodo"`
`DocumentId`*	`"sed quis in irure deserunt"`

Request Payload

Response Payload

{
  "DeleteResponse": {
    "Response": {
      "Alert": [
        {
          "Code": "9",
          "Description": "System timeout"
        }
      ],
      "ResponseStatus": {
        "Code": "0",
        "Description": "Success"
      },
      "TransactionReference": {
        "CustomerContext": "0c90fa63-3ea4-4ae2-8c23-74e7810a65b8"
      }
    }
  }
}

{
  "response": {
    "errors": [
      {
        "code": "3",
        "message": "Invalid request"
      },
      {
        "code": "1",
        "message": "Unauthorized"
      },
      {
        "code": "2",
        "message": "Internal server error"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "1",
        "message": "Invalid request"
      },
      {
        "code": "8",
        "message": "Invalid request"
      },
      {
        "code": "3",
        "message": "Not found"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "0",
        "message": "Unauthorized"
      },
      {
        "code": "6",
        "message": "Not found"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "5",
        "message": "Not found"
      },
      {
        "code": "1",
        "message": "Not found"
      }
    ]
  }
}

Service Homepage: github.com/UPS-API/api-documentation/blob/main/Paperless-Ready.yaml

upsshippinglogisticspaperlessdocuments