Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Use the orderId and get the order from our API described in Orders.

  2. Loop through assets and do necessary actions

    Files can occur on both order level and order line level.

    Example (JavaScript)

    Code Block
     fetch('https://beta-api.ambita.com/kode/v1/orders/:orderId')
       .then(response => {
         response.orders.forEach(order => {
           if (order.assets.length > 0) {
             // loop through order assets and do necessary actions
           }
    
           order.orderLines.forEach(orderLine => {
             if (orderLine.assets.length > 0) {
               // loop through order line assets and do necessary actions
             }
           });
         });
       });
    
  3. Delete or save the file

    Response from https://beta-api.ambita.com/kode/v1/orders/:orderId

    Code Block
     {
       "id": 1234567,
       "status": "PROGRESS",
       ...
       "orders": [
         {
           "id": 1234567,
           "supplierName": "Infoland Kommune - demo",
           "assets": [
             ...
           ],
           ...
           "orderLines": [
             {
               "id": 12345678,
               "assets": [
                 ...
               ]
    

    Take a look at the Delivered files section, the id of the asset will be unique and should be stored in your system. Use this id as a reference to check if you have downloaded the asset before, this way you won’t end up with duplicates. You should also check the status of the asset and delete the file if it has status DELETED.

Distributor messages

You should implement handling of these messages, see Distributor Messages for more info.