Attach a document to an order response
How to attach a document to an order or line response
You can attach documents using three methods:
Upload your document to the Tradecloud object-storage and attach the
objectId
to the order or line.Upload your document to your company's content server and attach the
url
to the order or line.Only attach document meta data, such as document code/number, revision and name.
Method 1. Attach a document using the Tradecloud object-storage
Step 1. Upload a document to the Tradecloud object-storage
Use the Upload document endpoint to upload the document to the Tradecloud object-storage and remember the returned document objectId
.
Step 2. Attach the uploaded document in the order message using the /order/order-response
API
/order/order-response
APIYou can attach documents using the documents
field on either order
or lines
level in the body of the Send order response endpoint:
This will NOT create an OrderDocumentsAttachedBySupplier
activity and NO acknowledge task for the buyer.
The total number of documents is limited to 100 documents per order header and per order line.
Documents body
code
: optional document code or number. The document code should be unique within your company and immutable.
If a document with the same code is already attached to the order or line, the document will be replaced, else it will be appended.
revision
: optional document revision (or version) code or numbername
: optional document short (file) namedescription
: optional document description or long nametype
: optional document business typeobjectId
: the Tradecloud object identifier which was returned by the Tradecloud object-storage upload
Method 2. Attach a document using your company's content server
Step 1. Upload to your company's content server
Upload documents to your company's content server and remember the returned document url
.
Step 2. Provide the url
in the order message using the /order/order-response
API
url
in the order message using the /order/order-response
APIYou can provide the url
using the documents
field on either order
or lines
level in the order body of the Send order response endpoint.
This will NOT create an OrderDocumentsAttachedBySupplier
activity and NO acknowledge task for the buyer.
Documents body
code
: optional document code or number. The document code should be unique within your company and immutable.
If a document with the same code is already attached to the order or line, the document will be replaced, else it will be appended.
revision
: optional document revision (or version) code or numbername
: optional document short (file) namedescription
: optional document description or long nametype
: optional document business typeurl
: the document location on the company's content server
Method 3. Only provide document meta data
Only provide document meta data like code, revision, name, description and type.
You can provide the meta data using the documents
field on either order
or lines
level in the order body of the Send order response endpoint.
This will NOT create an OrderDocumentsAttachedBySupplier
activity and NO acknowledge task for the buyer.
Documents body
code
: optional document code or number. The document code should be unique within your company and immutable.
If a document with the same code is already attached to the order or line, the document will be replaced, else it will be appended.
revision
: optional document revision (or version) code or numbername
: optional document short (file) namedescription
: optional document description or long nametype
: optional document business type
Last updated