Tradecloud API v2 manual
  • Introduction
    • Welcome
      • Checklist
      • Support
    • API
      • Rules
      • Requests
      • JSON versus XML
      • Environments
      • Standards
      • Compatibility
      • Tools
        • Swagger UI
        • Postman
        • .NET SDK
      • Webhook versus polling
        • Polling usage
        • Polling echo
      • Delivery schedule
    • Security
      • Security overview
      • Authentication
      • Authorization
      • Encryption
      • Document storage
  • Guide
    • 1. Getting an Account
    • 2. Sending your first order
      • Option A: Sending a Delivery Schedule per order line
      • Option B: Sending a Single Delivery per order line
  • Processes
    • Forecasts
      • Issue a new forecast
      • Issue a new Slimstock forecast
    • Orders
      • Buyer order process
        • Issue a new order
          • Delivery schedule
          • Indicators
          • No delivery expected
          • Propose when accepted
          • Attach a document to an order
          • Choose attach document API
        • Update an existing order
        • Receive an order response
          • Download a document attached to an order response
          • Single delivery order response
        • Receive goods
        • Complete an order
        • Reopen an order
        • Cancel an order
      • Supplier order process
        • Receive an order
          • Download a document attached to an order
          • Single delivery order
        • Send order response
          • Attach a document to an order response
        • Reopen an order
        • Cancel an order
    • Shipments
      • Supplier shipment process
        • Send despatch advice
      • Buyer shipment process
        • Receive a shipment event
          • Download a document attached to a shipment
Powered by GitBook
On this page
  1. Guide
  2. 2. Sending your first order

Option A: Sending a Delivery Schedule per order line

Previous2. Sending your first orderNextOption B: Sending a Single Delivery per order line

Last updated 1 month ago

This page explains how to send your first order with a Delivery Schedule. A Delivery Schedule can contain 1 or multiple requested deliveries for a single order line.

Sending the order

  1. Set the URL to https://api.accp.tradecloud1.com/v2/api-connector/order

  2. Set the HTTP Method to POST

  3. Provide a Basic Authentication header, which contains the of the integration account.

  4. Provide the JSON below as the request body. Make sure you replace {{supplierAccountNumber}} with the supplier account number you have for a test supplier.

Set the request body MIME-type to application/json.

{
  "order": {
    "supplierAccountNumber": "{{supplierAccountNumber}}",
    "purchaseOrderNumber": "PO123456789",
    "destination": {
      "names": [
        "My Company Warehouse",
        "Dock 12"
      ],
      "countryCodeIso2": "NL"
    }
  },
  "lines": [
    {
      "position": "0001",
      "item": {
        "name": "Round tube 60x45",
        "purchaseUnitOfMeasureIso": "PCE"
      },
      "deliverySchedule": [
        {
          "date": "2026-01-31",
          "quantity": 5
        },
        {
          "date": "2026-02-07",
          "quantity": 10
        }
      ],
      "prices": {
        "netPrice": {
          "priceInTransactionCurrency": {
            "value": 1234.56,
            "currencyIso": "EUR"
          }
        },
        "priceUnitOfMeasureIso": "PCE",
        "priceUnitQuantity": 100
      }
    }
  ]
}

Set the request MIME-type to application/xml

<?xml version="1.0" encoding="UTF-8"?>
<SendOrderByBuyer>
	<order>
		<supplierAccountNumber>{{supplierAccountNumber}}</supplierAccountNumber>
		<purchaseOrderNumber>PO123456789</purchaseOrderNumber>
		<destination>
			<name>My Company Warehouse</name>
			<name>Dock 12</name>
			<countryCodeIso2>NL</countryCodeIso2>
		</destination>
	</order>
	<line>
		<position>0001</position>
		<item>
			<name>Round tube 60x45</name>
			<purchaseUnitOfMeasureIso>PCE</purchaseUnitOfMeasureIso>
		</item>
		<deliveryScheduleLine>
			<date>2026-01-31</date>
			<quantity>5</quantity>
		</deliveryScheduleLine>
		<deliveryScheduleLine>
			<date>2026-02-07</date>
			<quantity>10</quantity>
		</deliveryScheduleLine>
		<prices>
			<netPrice>
				<priceInTransactionCurrency>
					<value>1234.56</value>
					<currencyIso>EUR</currencyIso>
				</priceInTransactionCurrency>
			</netPrice>
			<priceUnitOfMeasureIso>PCE</priceUnitOfMeasureIso>
			<priceUnitQuantity>100</priceUnitQuantity>
		</prices>
	</line>
</SendOrderByBuyer>

That's all! You can now log into the and go to the Order overview page. When you click the order line, you can now see the requested Delivery Schedule.

username and password
configured
Web Portal