Afosto Api API Reference

Introduction

Welcome to Afosto API documentation. Here you will find resource addresses and explanations on how to use our API to access various parts of data which we provide to you - our customers. On the right side of the screen you can preview examples of the responses each API endpoint produces Please take into consideration, that there is one address, and one address only you should use for purposes of the api connections. This is the address you are required to use: https://api.afosto.io

Authentication

Afosto Uses OAuth2 with JWT tokens for its authentication

API Endpoint
https://api.afosto.io
Contact: support@afosto.com
Request Content-Types: application/json
Response Content-Types: application/json
Schemes: https
Version: 1.0.0

Authentication

Bearer

Some endpoints within the API require that you have access to certain scopes. A List of available scopes are defined below.

type
oauth2
authorizationUrl
https://app.afosto.io/scopes
flow
implicit
scopes
app:integrations:read

Grants read access for integrations

app:integrations:write

Grants write access for integrations

cat:channel:read

Grants read access to channels

cat:channel:write

Grants write access to channels

cat:mapping:read

Grants read access for mapping

cat:mapping:write

Grants write access for mapping

cat:prices:read

Read product prices

cat:prices:write

Write to product prices

cnt:files:read

Grants read access for files

cnt:files:write

Grants write access to the file service

cnt:filesystems:read

Grants filesystems read access

cnt:filesystems:write

Grants filesystems write access

cnt:index:read

Grants tenant read access

cnt:index:write

Update definitions / add contents

cnt:instant:read

Grants read access to instant search

cnt:instant:write

Grants write access to instant search

cnt:proxies:read

Grants read access for proxies

cnt:proxies:write

Grants write access for proxies

cnt:video:read

Grants read access for video / animated content

email

Returns email and verification status claims

iam:2fa:read

Grants 2 factor authentication read access for current user

iam:2fa:write

Grants 2 factor authentication write access for current user

iam:audits:read

Read audit logs

iam:customer:read

Grants read access to customer data

iam:customer:write

Grants write access to customer data

iam:logs:read

Read logs

iam:oauth:read

Grants read access to oauth clients

iam:oauth:write

Grants write access to oauth clients

iam:roles:read

Grants read access to rbac roles

iam:roles:write

Grants write access to rbac roles

iam:services:read

Grants read access to services

iam:services:write

Grants write access to services

iam:sources:read

Grants limited read access to customer payment sources

iam:sources:write

Grants write access to customer payment sources

iam:subscriptions:read

Grants subscription read access

iam:subscriptions:write

Grants subscription write access

iam:tenants:read

Grants tenant read access

iam:usage:read

Grants usage read access

iam:users:read

Grants read access to users

iam:users:write

Grants write access to users

lcs:dpd:read

Grants DPD read access

lcs:handling:read

Grants read access for handling lists and parcels

lcs:handling:write

Grants write access for handling lists and parcels

lcs:locations:read

Grants read access for fulfilment locations

lcs:locations:write

Grants write access for fulfilment locations

lcs:points:read

Grants read access for parcel points

lcs:shipments:read

Grants read access for shipments

lcs:shipments:write

Grants write access for shipments

mes:conversations:read

Grants read access to conversations

mes:conversations:register

Grants access to register upon a conversation

mes:conversations:write

Grants write access to conversations

mes:domains:read

Grants read access to domains

mes:domains:write

Grants write access to domains

mes:emails:read

Grants email read access

mes:emails:write

Grants email write access

mes:inboxes:read

Grants read access to inboxes

mes:inboxes:write

Grants write access to inboxes

mes:relays:read

Grants read access for relays

mes:relays:write

Grants write access for relays

mes:subscriptions:read

Grants subscription read access

mes:subscriptions:write

Grants subscription write access

mes:webhooks:read

Grants subscription read access

odr:coupons:read

Grants read access for coupons

odr:coupons:write

Grants write access coupons

odr:credit:read

Grants read access for credit

odr:credit:write

Grants write access to credit

odr:invoices:create

Grants create access for invoices

odr:invoices:read

Grants read access for the invoices

odr:invoices:update

Grants update access for invoices

odr:metrics:read

Grants read access for the metrics

odr:orders:read

Grants read access for the orders

odr:orders:write

Grants write access to orders

odr:payments:update

Grants update access for payments

odr:providers:read

Grants read access for the payment providers

odr:skus:write

Grants write access to skus for the stack service

odr:transactions:create

Grants create access for transactions

openid

Returns the sub / user id claim

profile

Returns profile information claims

qcq:proxies:read

Grants read access for proxies

qcq:proxies:write

Grants write access for proxies

rel:contacts:read

Grants read access for the contacts

rel:contacts:write

Grants create access for address

rel:geocode:read

grants read access for geocoding

rel:identity:read

grants write access for identity

rel:identity:write

grants write access for identity

spl:hubs:read

Grants read access for hubs

spl:hubs:write

Grants write access for hubs

spl:logs:read

Grants read access to hub logs

spl:logs:write

Grants write access for logging hub information

spl:network:read

Grants read access for network listings

spl:network:write

Grants write access for network listings

spl:printers:read

Grants read access for printers

spl:printers:write

Grants write access for printers

spl:queue:create

Grants create access to the queue

spl:queue:read

Grants read access for the queued jobs

spl:queue:update

Grants update permission for jobs on the queue

tpl:themes:read

Grants read access for themes

tpl:themes:write

Grants write access for themes

wms:claim:read

Grants read access to claim

wms:claim:write

Grants write access to claim

wms:hops:read

Grants read access to hops

wms:hops:write

Grants write access to hops

wms:item:read

Grants read access to item

wms:item:write

Grants write access to item

wms:location:read

Grants read access to location

wms:location:write

Grants write access to location

wms:route:read

Grants read access to route

wms:route:write

Grants write access to route

wms:schedule:read

Grants read access to schedule

wms:schedule:write

Grants write access to schedule

wms:sub:read

Grants read access to sub

wms:sub:write

Grants write access to sub

wms:transfer:read

Grants read access to transfer

wms:transfer:write

Grants write access to transfer

MesConversations

MesConversations

List conversations

GET /mes/conversations

Returns a list of conversations

x-page: string 1
in header

the requested page id

x-page-size: string 25
in header

the requested page size

200 OK
MesConversation

The list of conversations

type
MesConversation
400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "id": "string",
    "event": "string",
    "entity_type": "string",
    "entity_id": "string",
    "messages": [
      {
        "content": "string",
        "participant_reference": "string",
        "is_private": "boolean",
        "metadata": "object",
        "created_at": "string (date-time)"
      }
    ],
    "participants": [
      {
        "name": "string",
        "reference": "string",
        "is_machine": "boolean",
        "notifications": [
          {
            "address": "string",
            "medium": "string"
          }
        ]
      }
    ],
    "metadata": "object",
    "started_at": "string (date-time)",
    "expires_at": "string (date-time)",
    "created_at": "string (date-time)",
    "updated_at": "string (date-time)"
  }
]
Response Headers (200 OK)
x-page

undefined

 string
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer mes:conversations:read
MesConversations

Start a conversations conversation

POST /mes/conversations

Instantiate a conversation

MesConversationCreate

Conversation object

Request Example
{
  "event": "string",
  "entity_type": "string",
  "name": "string",
  "entity_id": "string",
  "participant": {
    "name": "string",
    "reference": "string",
    "is_machine": "boolean"
  },
  "metadata": "object",
  "expires_at": "string (date-time)"
}
200 OK
MesConversation

The started conversation

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
{
  "id": "string",
  "event": "string",
  "entity_type": "string",
  "entity_id": "string",
  "messages": [
    {
      "content": "string",
      "participant_reference": "string",
      "is_private": "boolean",
      "metadata": "object",
      "created_at": "string (date-time)"
    }
  ],
  "participants": [
    {
      "name": "string",
      "reference": "string",
      "is_machine": "boolean",
      "notifications": [
        {
          "address": "string",
          "medium": "string"
        }
      ]
    }
  ],
  "metadata": "object",
  "started_at": "string (date-time)",
  "expires_at": "string (date-time)",
  "created_at": "string (date-time)",
  "updated_at": "string (date-time)"
}
Response Headers (200 OK)
x-page

undefined

 string
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer mes:conversations:write
MesConversations

Search for conversations

POST /mes/conversations/search

Run a complex search to find conversations

MesSearch

Search query object

x-page: string 1
in header

the requested page id

x-page-size: string 25
in header

the requested page size

Request Example
{
  "constraints": [
    {
      "key": "string",
      "operator": "string",
      "value": [
        "string"
      ]
    }
  ]
}
200 OK
MesConversation

The list of search results

type
MesConversation
400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "id": "string",
    "event": "string",
    "entity_type": "string",
    "entity_id": "string",
    "messages": [
      {
        "content": "string",
        "participant_reference": "string",
        "is_private": "boolean",
        "metadata": "object",
        "created_at": "string (date-time)"
      }
    ],
    "participants": [
      {
        "name": "string",
        "reference": "string",
        "is_machine": "boolean",
        "notifications": [
          {
            "address": "string",
            "medium": "string"
          }
        ]
      }
    ],
    "metadata": "object",
    "started_at": "string (date-time)",
    "expires_at": "string (date-time)",
    "created_at": "string (date-time)",
    "updated_at": "string (date-time)"
  }
]
Response Headers (200 OK)
x-page

undefined

 string
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer mes:conversations:read
MesConversations

View a conversation

GET /mes/conversations/{id}

Retrieve a single conversation

id: integer
in path

(no description)

200 OK
MesConversation

The conversation with given id

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
{
  "id": "string",
  "event": "string",
  "entity_type": "string",
  "entity_id": "string",
  "messages": [
    {
      "content": "string",
      "participant_reference": "string",
      "is_private": "boolean",
      "metadata": "object",
      "created_at": "string (date-time)"
    }
  ],
  "participants": [
    {
      "name": "string",
      "reference": "string",
      "is_machine": "boolean",
      "notifications": [
        {
          "address": "string",
          "medium": "string"
        }
      ]
    }
  ],
  "metadata": "object",
  "started_at": "string (date-time)",
  "expires_at": "string (date-time)",
  "created_at": "string (date-time)",
  "updated_at": "string (date-time)"
}
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer mes:conversations:read
MesConversations

Add a message

POST /mes/conversations/{id}/messages

Append a message to the conversation

MesMessageAdd

The new message

id: integer
in path

(no description)

Request Example
{
  "content": "string",
  "is_private": "boolean",
  "metadata": "object",
  "reference": "string"
}
200 OK
MesConversation

The resulting conversation

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
{
  "id": "string",
  "event": "string",
  "entity_type": "string",
  "entity_id": "string",
  "messages": [
    {
      "content": "string",
      "participant_reference": "string",
      "is_private": "boolean",
      "metadata": "object",
      "created_at": "string (date-time)"
    }
  ],
  "participants": [
    {
      "name": "string",
      "reference": "string",
      "is_machine": "boolean",
      "notifications": [
        {
          "address": "string",
          "medium": "string"
        }
      ]
    }
  ],
  "metadata": "object",
  "started_at": "string (date-time)",
  "expires_at": "string (date-time)",
  "created_at": "string (date-time)",
  "updated_at": "string (date-time)"
}
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer mes:conversations:write
MesConversations

Add a participant

POST /mes/conversations/{id}/register

Register a new participant in the conversation

MesParticipantCreate

The new message

id: integer
in path

(no description)

Request Example
{
  "name": "string",
  "reference": "string",
  "is_machine": "boolean"
}
200 OK
MesConversation

The resulting conversation

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
{
  "id": "string",
  "event": "string",
  "entity_type": "string",
  "entity_id": "string",
  "messages": [
    {
      "content": "string",
      "participant_reference": "string",
      "is_private": "boolean",
      "metadata": "object",
      "created_at": "string (date-time)"
    }
  ],
  "participants": [
    {
      "name": "string",
      "reference": "string",
      "is_machine": "boolean",
      "notifications": [
        {
          "address": "string",
          "medium": "string"
        }
      ]
    }
  ],
  "metadata": "object",
  "started_at": "string (date-time)",
  "expires_at": "string (date-time)",
  "created_at": "string (date-time)",
  "updated_at": "string (date-time)"
}
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer mes:conversations:register
MesConversations

Add a subscription

POST /mes/conversations/{id}/subscribe

Add a subscription to recieve updates on this conversation

MesSubscription

The subscription data

id: integer
in path

(no description)

Request Example
{
  "reference": "string",
  "medium": "string",
  "address": "boolean"
}
200 OK
MesConversation

The resulting conversation

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
{
  "id": "string",
  "event": "string",
  "entity_type": "string",
  "entity_id": "string",
  "messages": [
    {
      "content": "string",
      "participant_reference": "string",
      "is_private": "boolean",
      "metadata": "object",
      "created_at": "string (date-time)"
    }
  ],
  "participants": [
    {
      "name": "string",
      "reference": "string",
      "is_machine": "boolean",
      "notifications": [
        {
          "address": "string",
          "medium": "string"
        }
      ]
    }
  ],
  "metadata": "object",
  "started_at": "string (date-time)",
  "expires_at": "string (date-time)",
  "created_at": "string (date-time)",
  "updated_at": "string (date-time)"
}
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer mes:conversations:write
MesConversations

Cancel a subscription

POST /mes/conversations/{id}/unsubscribe

Remove a subscription to recieve updates on this conversation

MesCancel

The subscription data

id: integer
in path

(no description)

Request Example
{
  "reference": "string",
  "medium": "string"
}
200 OK
MesConversation

The resulting conversation

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
{
  "id": "string",
  "event": "string",
  "entity_type": "string",
  "entity_id": "string",
  "messages": [
    {
      "content": "string",
      "participant_reference": "string",
      "is_private": "boolean",
      "metadata": "object",
      "created_at": "string (date-time)"
    }
  ],
  "participants": [
    {
      "name": "string",
      "reference": "string",
      "is_machine": "boolean",
      "notifications": [
        {
          "address": "string",
          "medium": "string"
        }
      ]
    }
  ],
  "metadata": "object",
  "started_at": "string (date-time)",
  "expires_at": "string (date-time)",
  "created_at": "string (date-time)",
  "updated_at": "string (date-time)"
}
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer mes:conversations:write

OdrOrders

OdrOrders

List orders

GET /odr/orders

Returns a list of orders

x-page: string 1
in header

the requested page id

x-page-size: string 25
in header

the requested page size

authorization_id: string
in query

(no description)

number: string
in query

(no description)

200 OK
OdrOrder

The list of orders

type
OdrOrder
400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "id": "string (uuid)",
    "number": "string",
    "state": {
      "is_locked": "boolean",
      "is_accepted": "boolean",
      "is_confirmed": "boolean",
      "is_finished": "boolean",
      "is_canceled": "boolean",
      "type": "string",
      "flow": [
        {
          "code": "string",
          "order": "integer",
          "is_reversible": "boolean",
          "trigger": "string",
          "actions": [
            {
              "code": "string",
              "order": "integer",
              "label": "string",
              "is_handled": "boolean",
              "handled_at": "string (date-time)"
            }
          ]
        }
      ],
      "progress": {
        "allocation": "string",
        "fulfilment": "string",
        "billing": "string"
      }
    },
    "settings": {
      "contact": {
        "id": "string (uuid)",
        "version": "string (uuid)"
      },
      "organisation": {
        "id": "string (uuid)",
        "version": "string (uuid)"
      },
      "phone_number_id": "string (uuid)",
      "coupons": [
        "string"
      ],
      "due_at": "string (date)",
      "return_url": "string",
      "billing": {
        "address_id": "string (uuid)",
        "method_code": "string",
        "issuer_code": "string",
        "provider_code": "string"
      },
      "shipping": {
        "address_id": "string (uuid)",
        "source_address_id": "string (uuid)",
        "method_id": "string (uuid)",
        "spid": "string",
        "window": {
          "from": "integer",
          "to": "integer",
          "delivery_at": "string (date)",
          "code": "string"
        },
        "is_split_allowed": "boolean"
      }
    },
    "processing": {
      "confirm": "string",
      "allocation": "string",
      "fulfilment": "string",
      "capture": "string"
    },
    "acceptances": [
      {
        "id": "string (uuid)",
        "amount": "integer",
        "is_prepaid": "boolean",
        "is_settlement": "boolean",
        "is_paid": "boolean",
        "calculation_id": "string (uuid)",
        "transaction_secret": "string",
        "created_at": "string (date-time)",
        "accepted_at": "string (date-time)"
      }
    ],
    "calculations": [
      {
        "id": "string (uuid)",
        "reference": "string",
        "currency": "string",
        "client_id": "string (uuid)",
        "amount": "integer",
        "is_valid": "boolean",
        "is_accepted": "boolean",
        "is_confirmed": "boolean",
        "expires_at": "string (date-time)"
      }
    ],
    "client_id": "string",
    "tags": [
      "string"
    ],
    "stack_id": "string",
    "type": "string",
    "last_accepted_at": "string (date-time)",
    "last_confirmed_at": "string (date-time)",
    "last_canceled_at": "string (date-time)",
    "created_at": "string (date-time)",
    "updated_at": "string (date-time)"
  }
]
Response Headers (200 OK)
x-page

undefined

 string
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:read
OdrOrders

Create order

POST /odr/orders

Creates and returns the new order

OdrOrderModel

undefined

x-idempotency-key: string
in header

(no description)

Request Example
{
  "processing": {
    "confirm": "string",
    "allocation": "string",
    "fulfilment": "string",
    "capture": "string"
  },
  "settings": {
    "contact": {
      "id": "string (uuid)"
    },
    "organisation": {
      "id": "string (uuid)"
    },
    "phone_number_id": "string (uuid)",
    "coupons": [
      "string"
    ],
    "due_at": "string (date)",
    "reference": "string (string)",
    "return_url": "string",
    "billing": {
      "address_id": "string (uuid)",
      "method_code": "string",
      "issuer_code": "string",
      "provider_code": "string",
      "vat": {
        "is_shift_disabled": "boolean",
        "is_shift_required": "boolean"
      }
    },
    "shipping": {
      "address_id": "string (uuid)",
      "source_address_id": "string (uuid)",
      "method_id": "string (uuid)",
      "spid": "string",
      "window": {
        "from": "integer",
        "to": "integer",
        "delivery_at": "string (date)",
        "code": "string"
      },
      "is_split_allowed": "boolean"
    }
  },
  "client_id": "string",
  "tags": [
    "string"
  ],
  "type": "string",
  "metadata": "object"
}
200 OK
OdrOrder

The order

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
{
  "id": "string (uuid)",
  "number": "string",
  "state": {
    "is_locked": "boolean",
    "is_accepted": "boolean",
    "is_confirmed": "boolean",
    "is_finished": "boolean",
    "is_canceled": "boolean",
    "type": "string",
    "flow": [
      {
        "code": "string",
        "order": "integer",
        "is_reversible": "boolean",
        "trigger": "string",
        "actions": [
          {
            "code": "string",
            "order": "integer",
            "label": "string",
            "is_handled": "boolean",
            "handled_at": "string (date-time)"
          }
        ]
      }
    ],
    "progress": {
      "allocation": "string",
      "fulfilment": "string",
      "billing": "string"
    }
  },
  "settings": {
    "contact": {
      "id": "string (uuid)",
      "version": "string (uuid)"
    },
    "organisation": {
      "id": "string (uuid)",
      "version": "string (uuid)"
    },
    "phone_number_id": "string (uuid)",
    "coupons": [
      "string"
    ],
    "due_at": "string (date)",
    "return_url": "string",
    "billing": {
      "address_id": "string (uuid)",
      "method_code": "string",
      "issuer_code": "string",
      "provider_code": "string"
    },
    "shipping": {
      "address_id": "string (uuid)",
      "source_address_id": "string (uuid)",
      "method_id": "string (uuid)",
      "spid": "string",
      "window": {
        "from": "integer",
        "to": "integer",
        "delivery_at": "string (date)",
        "code": "string"
      },
      "is_split_allowed": "boolean"
    }
  },
  "processing": {
    "confirm": "string",
    "allocation": "string",
    "fulfilment": "string",
    "capture": "string"
  },
  "acceptances": [
    {
      "id": "string (uuid)",
      "amount": "integer",
      "is_prepaid": "boolean",
      "is_settlement": "boolean",
      "is_paid": "boolean",
      "calculation_id": "string (uuid)",
      "transaction_secret": "string",
      "created_at": "string (date-time)",
      "accepted_at": "string (date-time)"
    }
  ],
  "calculations": [
    {
      "id": "string (uuid)",
      "reference": "string",
      "currency": "string",
      "client_id": "string (uuid)",
      "amount": "integer",
      "is_valid": "boolean",
      "is_accepted": "boolean",
      "is_confirmed": "boolean",
      "expires_at": "string (date-time)"
    }
  ],
  "client_id": "string",
  "tags": [
    "string"
  ],
  "stack_id": "string",
  "type": "string",
  "last_accepted_at": "string (date-time)",
  "last_confirmed_at": "string (date-time)",
  "last_canceled_at": "string (date-time)",
  "created_at": "string (date-time)",
  "updated_at": "string (date-time)"
}
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:write
OdrOrders

Get order

GET /odr/orders/{id}

Returns an order

id: string
in path

(no description)

200 OK
OdrOrder

The order

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
{
  "id": "string (uuid)",
  "number": "string",
  "state": {
    "is_locked": "boolean",
    "is_accepted": "boolean",
    "is_confirmed": "boolean",
    "is_finished": "boolean",
    "is_canceled": "boolean",
    "type": "string",
    "flow": [
      {
        "code": "string",
        "order": "integer",
        "is_reversible": "boolean",
        "trigger": "string",
        "actions": [
          {
            "code": "string",
            "order": "integer",
            "label": "string",
            "is_handled": "boolean",
            "handled_at": "string (date-time)"
          }
        ]
      }
    ],
    "progress": {
      "allocation": "string",
      "fulfilment": "string",
      "billing": "string"
    }
  },
  "settings": {
    "contact": {
      "id": "string (uuid)",
      "version": "string (uuid)"
    },
    "organisation": {
      "id": "string (uuid)",
      "version": "string (uuid)"
    },
    "phone_number_id": "string (uuid)",
    "coupons": [
      "string"
    ],
    "due_at": "string (date)",
    "return_url": "string",
    "billing": {
      "address_id": "string (uuid)",
      "method_code": "string",
      "issuer_code": "string",
      "provider_code": "string"
    },
    "shipping": {
      "address_id": "string (uuid)",
      "source_address_id": "string (uuid)",
      "method_id": "string (uuid)",
      "spid": "string",
      "window": {
        "from": "integer",
        "to": "integer",
        "delivery_at": "string (date)",
        "code": "string"
      },
      "is_split_allowed": "boolean"
    }
  },
  "processing": {
    "confirm": "string",
    "allocation": "string",
    "fulfilment": "string",
    "capture": "string"
  },
  "acceptances": [
    {
      "id": "string (uuid)",
      "amount": "integer",
      "is_prepaid": "boolean",
      "is_settlement": "boolean",
      "is_paid": "boolean",
      "calculation_id": "string (uuid)",
      "transaction_secret": "string",
      "created_at": "string (date-time)",
      "accepted_at": "string (date-time)"
    }
  ],
  "calculations": [
    {
      "id": "string (uuid)",
      "reference": "string",
      "currency": "string",
      "client_id": "string (uuid)",
      "amount": "integer",
      "is_valid": "boolean",
      "is_accepted": "boolean",
      "is_confirmed": "boolean",
      "expires_at": "string (date-time)"
    }
  ],
  "client_id": "string",
  "tags": [
    "string"
  ],
  "stack_id": "string",
  "type": "string",
  "last_accepted_at": "string (date-time)",
  "last_confirmed_at": "string (date-time)",
  "last_canceled_at": "string (date-time)",
  "created_at": "string (date-time)",
  "updated_at": "string (date-time)"
}
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:read
OdrOrders

Update order

PUT /odr/orders/{id}

Updates order settings

OdrOrderModel

undefined

id: string
in path

(no description)

Request Example
{
  "processing": {
    "confirm": "string",
    "allocation": "string",
    "fulfilment": "string",
    "capture": "string"
  },
  "settings": {
    "contact": {
      "id": "string (uuid)"
    },
    "organisation": {
      "id": "string (uuid)"
    },
    "phone_number_id": "string (uuid)",
    "coupons": [
      "string"
    ],
    "due_at": "string (date)",
    "reference": "string (string)",
    "return_url": "string",
    "billing": {
      "address_id": "string (uuid)",
      "method_code": "string",
      "issuer_code": "string",
      "provider_code": "string",
      "vat": {
        "is_shift_disabled": "boolean",
        "is_shift_required": "boolean"
      }
    },
    "shipping": {
      "address_id": "string (uuid)",
      "source_address_id": "string (uuid)",
      "method_id": "string (uuid)",
      "spid": "string",
      "window": {
        "from": "integer",
        "to": "integer",
        "delivery_at": "string (date)",
        "code": "string"
      },
      "is_split_allowed": "boolean"
    }
  },
  "client_id": "string",
  "tags": [
    "string"
  ],
  "type": "string",
  "metadata": "object"
}
200 OK
OdrOrder

The order

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
{
  "id": "string (uuid)",
  "number": "string",
  "state": {
    "is_locked": "boolean",
    "is_accepted": "boolean",
    "is_confirmed": "boolean",
    "is_finished": "boolean",
    "is_canceled": "boolean",
    "type": "string",
    "flow": [
      {
        "code": "string",
        "order": "integer",
        "is_reversible": "boolean",
        "trigger": "string",
        "actions": [
          {
            "code": "string",
            "order": "integer",
            "label": "string",
            "is_handled": "boolean",
            "handled_at": "string (date-time)"
          }
        ]
      }
    ],
    "progress": {
      "allocation": "string",
      "fulfilment": "string",
      "billing": "string"
    }
  },
  "settings": {
    "contact": {
      "id": "string (uuid)",
      "version": "string (uuid)"
    },
    "organisation": {
      "id": "string (uuid)",
      "version": "string (uuid)"
    },
    "phone_number_id": "string (uuid)",
    "coupons": [
      "string"
    ],
    "due_at": "string (date)",
    "return_url": "string",
    "billing": {
      "address_id": "string (uuid)",
      "method_code": "string",
      "issuer_code": "string",
      "provider_code": "string"
    },
    "shipping": {
      "address_id": "string (uuid)",
      "source_address_id": "string (uuid)",
      "method_id": "string (uuid)",
      "spid": "string",
      "window": {
        "from": "integer",
        "to": "integer",
        "delivery_at": "string (date)",
        "code": "string"
      },
      "is_split_allowed": "boolean"
    }
  },
  "processing": {
    "confirm": "string",
    "allocation": "string",
    "fulfilment": "string",
    "capture": "string"
  },
  "acceptances": [
    {
      "id": "string (uuid)",
      "amount": "integer",
      "is_prepaid": "boolean",
      "is_settlement": "boolean",
      "is_paid": "boolean",
      "calculation_id": "string (uuid)",
      "transaction_secret": "string",
      "created_at": "string (date-time)",
      "accepted_at": "string (date-time)"
    }
  ],
  "calculations": [
    {
      "id": "string (uuid)",
      "reference": "string",
      "currency": "string",
      "client_id": "string (uuid)",
      "amount": "integer",
      "is_valid": "boolean",
      "is_accepted": "boolean",
      "is_confirmed": "boolean",
      "expires_at": "string (date-time)"
    }
  ],
  "client_id": "string",
  "tags": [
    "string"
  ],
  "stack_id": "string",
  "type": "string",
  "last_accepted_at": "string (date-time)",
  "last_confirmed_at": "string (date-time)",
  "last_canceled_at": "string (date-time)",
  "created_at": "string (date-time)",
  "updated_at": "string (date-time)"
}
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:read
OdrOrders

Remove order

DELETE /odr/orders/{id}

Removes an order

id: string
in path

(no description)

200 OK
OdrStack

The stack

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
{
  "id": "string",
  "entity_id": "string",
  "entity_type": "string",
  "state": {
    "is_accepted": "boolean",
    "is_confirmed": "boolean",
    "is_finished": "boolean"
  },
  "created_at": "string (date-time)",
  "updated_at": "string (date-time)"
}
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:write
OdrOrders

Get backorders

GET /odr/orders/{id}/backorders

Returns all backorders for current order

id: string
in path

(no description)

200 OK
OdrOrder

The order

type
OdrOrder
400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "id": "string (uuid)",
    "number": "string",
    "state": {
      "is_locked": "boolean",
      "is_accepted": "boolean",
      "is_confirmed": "boolean",
      "is_finished": "boolean",
      "is_canceled": "boolean",
      "type": "string",
      "flow": [
        {
          "code": "string",
          "order": "integer",
          "is_reversible": "boolean",
          "trigger": "string",
          "actions": [
            {
              "code": "string",
              "order": "integer",
              "label": "string",
              "is_handled": "boolean",
              "handled_at": "string (date-time)"
            }
          ]
        }
      ],
      "progress": {
        "allocation": "string",
        "fulfilment": "string",
        "billing": "string"
      }
    },
    "settings": {
      "contact": {
        "id": "string (uuid)",
        "version": "string (uuid)"
      },
      "organisation": {
        "id": "string (uuid)",
        "version": "string (uuid)"
      },
      "phone_number_id": "string (uuid)",
      "coupons": [
        "string"
      ],
      "due_at": "string (date)",
      "return_url": "string",
      "billing": {
        "address_id": "string (uuid)",
        "method_code": "string",
        "issuer_code": "string",
        "provider_code": "string"
      },
      "shipping": {
        "address_id": "string (uuid)",
        "source_address_id": "string (uuid)",
        "method_id": "string (uuid)",
        "spid": "string",
        "window": {
          "from": "integer",
          "to": "integer",
          "delivery_at": "string (date)",
          "code": "string"
        },
        "is_split_allowed": "boolean"
      }
    },
    "processing": {
      "confirm": "string",
      "allocation": "string",
      "fulfilment": "string",
      "capture": "string"
    },
    "acceptances": [
      {
        "id": "string (uuid)",
        "amount": "integer",
        "is_prepaid": "boolean",
        "is_settlement": "boolean",
        "is_paid": "boolean",
        "calculation_id": "string (uuid)",
        "transaction_secret": "string",
        "created_at": "string (date-time)",
        "accepted_at": "string (date-time)"
      }
    ],
    "calculations": [
      {
        "id": "string (uuid)",
        "reference": "string",
        "currency": "string",
        "client_id": "string (uuid)",
        "amount": "integer",
        "is_valid": "boolean",
        "is_accepted": "boolean",
        "is_confirmed": "boolean",
        "expires_at": "string (date-time)"
      }
    ],
    "client_id": "string",
    "tags": [
      "string"
    ],
    "stack_id": "string",
    "type": "string",
    "last_accepted_at": "string (date-time)",
    "last_confirmed_at": "string (date-time)",
    "last_canceled_at": "string (date-time)",
    "created_at": "string (date-time)",
    "updated_at": "string (date-time)"
  }
]
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:read
OdrOrders

Get references

GET /odr/orders/{id}/references

Returns affiliated orders

id: string
in path

(no description)

200 OK
OdrOrder

The order

type
OdrOrder
400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "id": "string (uuid)",
    "number": "string",
    "state": {
      "is_locked": "boolean",
      "is_accepted": "boolean",
      "is_confirmed": "boolean",
      "is_finished": "boolean",
      "is_canceled": "boolean",
      "type": "string",
      "flow": [
        {
          "code": "string",
          "order": "integer",
          "is_reversible": "boolean",
          "trigger": "string",
          "actions": [
            {
              "code": "string",
              "order": "integer",
              "label": "string",
              "is_handled": "boolean",
              "handled_at": "string (date-time)"
            }
          ]
        }
      ],
      "progress": {
        "allocation": "string",
        "fulfilment": "string",
        "billing": "string"
      }
    },
    "settings": {
      "contact": {
        "id": "string (uuid)",
        "version": "string (uuid)"
      },
      "organisation": {
        "id": "string (uuid)",
        "version": "string (uuid)"
      },
      "phone_number_id": "string (uuid)",
      "coupons": [
        "string"
      ],
      "due_at": "string (date)",
      "return_url": "string",
      "billing": {
        "address_id": "string (uuid)",
        "method_code": "string",
        "issuer_code": "string",
        "provider_code": "string"
      },
      "shipping": {
        "address_id": "string (uuid)",
        "source_address_id": "string (uuid)",
        "method_id": "string (uuid)",
        "spid": "string",
        "window": {
          "from": "integer",
          "to": "integer",
          "delivery_at": "string (date)",
          "code": "string"
        },
        "is_split_allowed": "boolean"
      }
    },
    "processing": {
      "confirm": "string",
      "allocation": "string",
      "fulfilment": "string",
      "capture": "string"
    },
    "acceptances": [
      {
        "id": "string (uuid)",
        "amount": "integer",
        "is_prepaid": "boolean",
        "is_settlement": "boolean",
        "is_paid": "boolean",
        "calculation_id": "string (uuid)",
        "transaction_secret": "string",
        "created_at": "string (date-time)",
        "accepted_at": "string (date-time)"
      }
    ],
    "calculations": [
      {
        "id": "string (uuid)",
        "reference": "string",
        "currency": "string",
        "client_id": "string (uuid)",
        "amount": "integer",
        "is_valid": "boolean",
        "is_accepted": "boolean",
        "is_confirmed": "boolean",
        "expires_at": "string (date-time)"
      }
    ],
    "client_id": "string",
    "tags": [
      "string"
    ],
    "stack_id": "string",
    "type": "string",
    "last_accepted_at": "string (date-time)",
    "last_confirmed_at": "string (date-time)",
    "last_canceled_at": "string (date-time)",
    "created_at": "string (date-time)",
    "updated_at": "string (date-time)"
  }
]
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:read
OdrOrders

Get stacks

GET /odr/orders/{id}/stacks

Returns all affiliated line sets that orginate from the order. For example inventory allocation, shipment or parcel data.

id: string
in path

(no description)

200 OK
OdrStack

The order

type
OdrStack
400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "id": "string",
    "entity_id": "string",
    "entity_type": "string",
    "state": {
      "is_accepted": "boolean",
      "is_confirmed": "boolean",
      "is_finished": "boolean"
    },
    "created_at": "string (date-time)",
    "updated_at": "string (date-time)"
  }
]
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:read
OdrOrders

Reference stack

POST /odr/orders/{id}/stacks

Creates and returns the new stack

OdrReferenceModel

undefined

x-idempotency-key: string
in header

(no description)

id: string
in path

(no description)

Request Example
{
  "entity_id": "string",
  "entity_type": "string",
  "constraints": [
    {
      "key": "string",
      "operator": "string",
      "values": [
        "string"
      ]
    }
  ]
}
200 OK
OdrStack

The stack

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
{
  "id": "string",
  "entity_id": "string",
  "entity_type": "string",
  "state": {
    "is_accepted": "boolean",
    "is_confirmed": "boolean",
    "is_finished": "boolean"
  },
  "created_at": "string (date-time)",
  "updated_at": "string (date-time)"
}
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:write
OdrOrders

Get projection

GET /odr/orders/{id}/projection

Returns an order's projection

id: string
in path

(no description)

pricing_at: integer
in query

Unix timestamp

200 OK
OdrProjection

The projection

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
{
  "items": [
    {
      "reference": "string",
      "sku": "string",
      "description": "string",
      "type": "string",
      "amount": "integer",
      "is_discounted": "boolean",
      "quantity": "integer",
      "subtotal": "integer",
      "adjustments": [
        {
          "reference": "string",
          "description": "string",
          "amount": "number",
          "is_percentage": "boolean",
          "is_discount": "boolean",
          "result": {
            "is_applied_rule": "boolean",
            "rule_id": "string",
            "output": "integer"
          }
        }
      ],
      "vat_percentage": "integer",
      "total": "integer",
      "total_revenue": "integer"
    }
  ],
  "subtotal": "integer",
  "adjustments": [
    {
      "reference": "string",
      "description": "string",
      "amount": "number",
      "is_percentage": "boolean",
      "is_discount": "boolean",
      "result": {
        "is_applied_rule": "boolean",
        "rule_id": "string",
        "output": "integer"
      }
    }
  ],
  "services": [
    {
      "description": "string",
      "type": "string",
      "amount": "number",
      "is_percentage": "boolean",
      "quantity": "integer",
      "subtotal": "integer",
      "adjustments": [
        {
          "reference": "string",
          "description": "string",
          "amount": "number",
          "is_percentage": "boolean",
          "is_discount": "boolean",
          "result": {
            "is_applied_rule": "boolean",
            "rule_id": "string (uuid)",
            "output": "integer"
          }
        }
      ],
      "vat_percentage": "integer",
      "total": "integer"
    }
  ],
  "total": "integer",
  "vat": [
    {
      "rate": "integer",
      "amount": "integer"
    }
  ],
  "customer": {
    "vat_country_code": "string",
    "contact": {
      "email": "string",
      "vat_number": "string",
      "coc_number": "string",
      "organisation_id": "string",
      "organisation_version": "string",
      "address_id": "string",
      "phone_number_id": "string",
      "id": "string",
      "version": "string"
    }
  },
  "vendor": {
    "vat_country_code": "string",
    "contact": {
      "email": "string",
      "vat_number": "string",
      "coc_number": "string",
      "organisation_id": "string",
      "organisation_version": "string",
      "address_id": "string",
      "phone_number_id": "string",
      "id": "string",
      "version": "string"
    }
  },
  "currency": "string",
  "is_including_vat": "boolean",
  "is_vat_shifted": "boolean",
  "client_id": "string",
  "pricing_at": "string (date-time)"
}
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:read
OdrOrders

Get calculation

GET /odr/orders/{id}/calculation

Returns the newest, non expired, calculation for the order

id: string
in path

(no description)

200 OK
OdrCalculations

The calculation

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
{
  "id": "string",
  "number": "string",
  "items": [
    {
      "id": "string",
      "reference": "string",
      "sku": "string",
      "description": "string",
      "type": "string",
      "amount": "integer",
      "is_discounted": "boolean",
      "quantity": "integer",
      "subtotal": "integer",
      "adjustments": [
        {
          "reference": "string",
          "description": "string",
          "amount": "number",
          "is_percentage": "boolean",
          "is_discount": "boolean",
          "result": {
            "is_applied_rule": "boolean",
            "rule_id": "string",
            "output": "integer"
          }
        }
      ],
      "vat_percentage": "integer",
      "total": "integer",
      "total_revenue": "integer",
      "order_items": [
        {
          "id": "string",
          "is_invoiced": "boolean"
        }
      ]
    }
  ],
  "services": [
    {
      "description": "string",
      "type": "string",
      "amount": "number",
      "is_percentage": "boolean",
      "quantity": "integer",
      "subtotal": "integer",
      "adjustments": [
        {
          "reference": "string",
          "description": "string",
          "amount": "number",
          "is_percentage": "boolean",
          "is_discount": "boolean",
          "result": {
            "is_applied_rule": "boolean",
            "rule_id": "string (uuid)",
            "output": "integer"
          }
        }
      ],
      "vat_percentage": "integer",
      "total": "integer"
    }
  ],
  "subtotal": "integer",
  "adjustments": [
    {
      "reference": "string",
      "description": "string",
      "amount": "number",
      "is_percentage": "boolean",
      "is_discount": "boolean",
      "result": {
        "is_applied_rule": "boolean",
        "rule_id": "string",
        "output": "integer"
      }
    }
  ],
  "total": "integer",
  "vat": [
    {
      "rate": "integer",
      "amount": "integer"
    }
  ],
  "currency": "string",
  "customer": {
    "vat_country_code": "string",
    "contact": {
      "email": "string",
      "vat_number": "string",
      "coc_number": "string",
      "organisation_id": "string",
      "organisation_version": "string",
      "address_id": "string",
      "phone_number_id": "string",
      "id": "string",
      "version": "string"
    }
  },
  "vendor": {
    "vat_country_code": "string",
    "contact": {
      "email": "string",
      "vat_number": "string",
      "coc_number": "string",
      "organisation_id": "string",
      "organisation_version": "string",
      "address_id": "string",
      "phone_number_id": "string",
      "id": "string",
      "version": "string"
    }
  },
  "is_including_vat": "boolean",
  "is_vat_shifted": "boolean",
  "is_authorized": "boolean",
  "is_invoiced": "boolean",
  "is_prepaid": "boolean",
  "client_id": "string",
  "file_id": "string",
  "metadata": "object",
  "pricing_at": "string (date-time)",
  "created_at": "string (date-time)",
  "updated_at": "string (date-time)"
}
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:read
OdrOrders

Calculate order

POST /odr/orders/{id}/calculation

Request calculation for the order

OdrOrderCalculationRequest

undefined

id: string
in path

(no description)

x-idempotency-key: string
in header

(no description)

rules: integer 1, 0
in query

(no description)

Request Example
{
  "expires_at": "string (date-time)",
  "reference": "string",
  "currency": "string",
  "items": [
    {
      "item_ids": [
        "string (uuid)"
      ],
      "description": "string",
      "amount": "integer",
      "is_discounted": "boolean",
      "adjustments": [
        {
          "reference": "string",
          "description": "string",
          "amount": "number",
          "is_percentage": "boolean",
          "is_discount": "boolean"
        }
      ],
      "vat_percentage": "integer"
    }
  ],
  "adjustments": [
    {
      "reference": "string",
      "description": "string",
      "amount": "number",
      "is_percentage": "boolean",
      "is_discount": "boolean"
    }
  ],
  "pricing_at": "string (date-time)",
  "metadata": "object"
}
200 OK
OdrCalculations

The calculation

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
{
  "id": "string",
  "number": "string",
  "items": [
    {
      "id": "string",
      "reference": "string",
      "sku": "string",
      "description": "string",
      "type": "string",
      "amount": "integer",
      "is_discounted": "boolean",
      "quantity": "integer",
      "subtotal": "integer",
      "adjustments": [
        {
          "reference": "string",
          "description": "string",
          "amount": "number",
          "is_percentage": "boolean",
          "is_discount": "boolean",
          "result": {
            "is_applied_rule": "boolean",
            "rule_id": "string",
            "output": "integer"
          }
        }
      ],
      "vat_percentage": "integer",
      "total": "integer",
      "total_revenue": "integer",
      "order_items": [
        {
          "id": "string",
          "is_invoiced": "boolean"
        }
      ]
    }
  ],
  "services": [
    {
      "description": "string",
      "type": "string",
      "amount": "number",
      "is_percentage": "boolean",
      "quantity": "integer",
      "subtotal": "integer",
      "adjustments": [
        {
          "reference": "string",
          "description": "string",
          "amount": "number",
          "is_percentage": "boolean",
          "is_discount": "boolean",
          "result": {
            "is_applied_rule": "boolean",
            "rule_id": "string (uuid)",
            "output": "integer"
          }
        }
      ],
      "vat_percentage": "integer",
      "total": "integer"
    }
  ],
  "subtotal": "integer",
  "adjustments": [
    {
      "reference": "string",
      "description": "string",
      "amount": "number",
      "is_percentage": "boolean",
      "is_discount": "boolean",
      "result": {
        "is_applied_rule": "boolean",
        "rule_id": "string",
        "output": "integer"
      }
    }
  ],
  "total": "integer",
  "vat": [
    {
      "rate": "integer",
      "amount": "integer"
    }
  ],
  "currency": "string",
  "customer": {
    "vat_country_code": "string",
    "contact": {
      "email": "string",
      "vat_number": "string",
      "coc_number": "string",
      "organisation_id": "string",
      "organisation_version": "string",
      "address_id": "string",
      "phone_number_id": "string",
      "id": "string",
      "version": "string"
    }
  },
  "vendor": {
    "vat_country_code": "string",
    "contact": {
      "email": "string",
      "vat_number": "string",
      "coc_number": "string",
      "organisation_id": "string",
      "organisation_version": "string",
      "address_id": "string",
      "phone_number_id": "string",
      "id": "string",
      "version": "string"
    }
  },
  "is_including_vat": "boolean",
  "is_vat_shifted": "boolean",
  "is_authorized": "boolean",
  "is_invoiced": "boolean",
  "is_prepaid": "boolean",
  "client_id": "string",
  "file_id": "string",
  "metadata": "object",
  "pricing_at": "string (date-time)",
  "created_at": "string (date-time)",
  "updated_at": "string (date-time)"
}
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:read
OdrOrders

Authorize order

POST /odr/orders/{id}/authorize

Request authorization for the order. Upon authorization (directly or after payment), the order will be processed automatically.

calculation_id: string (uuid)
x-idempotency-key: string
in header

(no description)

id: string
in path

(no description)

Request Example
{
  "calculation_id": "string (uuid)"
}
200 OK
OdrOrderAuthorizationResponse

The order

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
{
  "is_locked": "boolean",
  "is_accepted": "boolean",
  "is_confirmed": "boolean",
  "transaction_secret": "string"
}
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:read
OdrOrders

Accept order

POST /odr/orders/{id}/accept

Update the order state

id: string
in path

(no description)

204 No Content

Accepted

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:write
OdrOrders

Confirm order

POST /odr/orders/{id}/confirm

Update the order state

id: string
in path

(no description)

204 No Content

Accepted

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:write
OdrOrders

Allocate order

POST /odr/orders/{id}/allocate

allocate the order

id: string
in path

(no description)

202 Accepted

Accepted

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Headers (202 Accepted)
x-task-id

undefined

 string (uuid)
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:write
OdrOrders

Fulfil order

POST /odr/orders/{id}/fulfil

fulfil the order

id: string
in path

(no description)

202 Accepted

Accepted

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Headers (202 Accepted)
x-task-id

undefined

 string (uuid)
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:write
OdrOrders

Cancel order

POST /odr/orders/{id}/cancel

Cancel the order

id: string
in path

(no description)

force: string 1, 0
in query

(no description)

200 OK
OdrCancelState

Status

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
{
  "is_accepted": "boolean",
  "warnings": [
    "string"
  ]
}
Response Headers (200 OK)
x-task-id

undefined

 string (uuid)
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:write
OdrOrders

Update state

PUT /odr/orders/{id}/flow

Update the order state

code: string
actions: object[]
object
code: string
is_handled: boolean
id: string
in path

(no description)

Request Example
{
  "code": "approval",
  "actions": [
    {
      "code": "manager_approve",
      "is_handled": true
    }
  ]
}
204 No Content

Accepted

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:write

OdrItems

OdrItems

List items

GET /odr/orders/{id}/items

Returns a list of items

id: string
in path

(no description)

stack_id: string (uuid)
in query

(no description)

x-page: string 1
in header

the requested page id

x-page-size: string 25
in header

the requested page size

200 OK
OdrGroup

The list of items

type
OdrGroup
400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "sku": "string",
    "reference": "string",
    "description": "string",
    "quantity": "integer",
    "ids": [
      "string (uuid)"
    ],
    "references": {
      "orders": [
        {
          "id": "string (uuid)",
          "is_inbound": "boolean",
          "is_backordered": "boolean",
          "is_unavailable": "boolean",
          "warehouse": {
            "claim_id": "string (uuid)",
            "delivery_route_id": "string (uuid)",
            "collect_route_id": "string (uuid)",
            "is_reservation": "boolean",
            "address_id": "string",
            "transfer_id": "string (uuid)"
          },
          "shipments": [
            {
              "id": "string (uuid)",
              "is_inbound": "boolean",
              "is_missing": "boolean"
            }
          ]
        }
      ],
      "backorders": [
        "string (uuid)"
      ],
      "target": "string"
    },
    "filters": [
      {
        "key": "string",
        "values": [
          "string"
        ]
      }
    ]
  }
]
Response Headers (200 OK)
x-count

undefined

 string
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:read
OdrItems

Add items

POST /odr/orders/{id}/items

Adds items to the stack that was previously created

OdrOrderItemModel
id: string
in path

(no description)

x-idempotency-key: string
in header

(no description)

Request Example
[
  {
    "sku": "string",
    "reference": "string (uuid)",
    "description": "string",
    "quantity": "integer",
    "is_inbound": "boolean",
    "is_backorder": "boolean",
    "item_ids": [
      "string (uuid)"
    ],
    "source_order_id": "string (uuid)"
  }
]
200 OK
OdrSimpleOrderItem

The stack

type
OdrSimpleOrderItem
400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "id": "string",
    "reference": "string",
    "sku": "string",
    "description": "string",
    "is_inbound": "boolean"
  }
]
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:write
OdrItems

Delete items

DELETE /odr/orders/{id}/items

Delete items by ID

string (uuid)
id: string
in path

(no description)

Request Example
[
  "string (uuid)"
]
204 No Content

Items deleted

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:read
OdrItems

From search

POST /odr/orders/{id}/items/search

Add items to order based on item search

is_backorder: boolean
is_inbound: boolean
constraints: OdrSearchConstraint
OdrSearchConstraint
filters: OdrSearchFilter
OdrSearchFilter
id: string
in path

(no description)

Request Example
{
  "is_backorder": "boolean",
  "is_inbound": "boolean",
  "constraints": [
    {
      "key": "string",
      "operator": "string",
      "values": [
        "string"
      ]
    }
  ],
  "filters": [
    {
      "key": "string",
      "values": [
        "string"
      ]
    }
  ]
}
200 OK
OdrOrderItem

The list of groups

type
OdrOrderItem
400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "id": "string",
    "reference": "string",
    "sku": "string",
    "description": "string",
    "order_id": "string (uuid)",
    "references": {
      "orders": [
        {
          "id": "string (uuid)",
          "is_inbound": "boolean",
          "is_available": "boolean",
          "is_backorder": "boolean",
          "warehouse": {
            "claimed_at": "string (date-time)",
            "claim_id": "string (uuid)",
            "claim_item_id": "string (uuid)",
            "route_id": "string (uuid)",
            "is_reservation": "boolean",
            "transfer_id": "string (uuid)"
          },
          "shipments": [
            {
              "id": "string (uuid)",
              "is_inbound": "boolean",
              "is_missing": "boolean"
            }
          ],
          "backorders": [
            "string"
          ],
          "target": "string"
        }
      ],
      "stacks": [
        {
          "id": "string",
          "type": "string",
          "state": {
            "is_locked": "boolean",
            "is_accepted": "boolean",
            "is_confirmed": "boolean",
            "is_finished": "boolean"
          }
        }
      ]
    },
    "filters": [
      {
        "key": "string",
        "values": [
          "string"
        ]
      }
    ]
  }
]
Response Headers (200 OK)
x-count

undefined

 string
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:write
OdrItems

Attach warehouse item onto an order item

POST /odr/orders/{id}/items/attach

set the warehouse item on a product.

object
order_item_id: string (uuid)
inventory_item_id: string (uuid)
id: string
in path

(no description)

Request Example
[
  {
    "order_item_id": "string (uuid)",
    "inventory_item_id": "string (uuid)"
  }
]
200 OK
OdrOrderItem

The list of groups

type
OdrOrderItem
400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "id": "string",
    "reference": "string",
    "sku": "string",
    "description": "string",
    "order_id": "string (uuid)",
    "references": {
      "orders": [
        {
          "id": "string (uuid)",
          "is_inbound": "boolean",
          "is_available": "boolean",
          "is_backorder": "boolean",
          "warehouse": {
            "claimed_at": "string (date-time)",
            "claim_id": "string (uuid)",
            "claim_item_id": "string (uuid)",
            "route_id": "string (uuid)",
            "is_reservation": "boolean",
            "transfer_id": "string (uuid)"
          },
          "shipments": [
            {
              "id": "string (uuid)",
              "is_inbound": "boolean",
              "is_missing": "boolean"
            }
          ],
          "backorders": [
            "string"
          ],
          "target": "string"
        }
      ],
      "stacks": [
        {
          "id": "string",
          "type": "string",
          "state": {
            "is_locked": "boolean",
            "is_accepted": "boolean",
            "is_confirmed": "boolean",
            "is_finished": "boolean"
          }
        }
      ]
    },
    "filters": [
      {
        "key": "string",
        "values": [
          "string"
        ]
      }
    ]
  }
]
Response Headers (200 OK)
x-count

undefined

 string
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:write
OdrItems

Remove the allocation from an order item

POST /odr/orders/{id}/items/cancel

set the warehouse item on a product.

string
id: string
in path

(no description)

Request Example
[
  "string"
]
204 No Content

when successfully dealocated

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:write
OdrItems

List items with routing

GET /odr/orders/{id}/items/routing

Returns a list of items

id: string
in path

(no description)

x-page: string 1
in header

the requested page id

x-page-size: string 25
in header

the requested page size

200 OK
OdrGroupRoute

The list of items

type
OdrGroupRoute
400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "sku": "string",
    "reference": "string",
    "description": "string",
    "quantity": "integer",
    "order_id": "string (uuid)",
    "ids": [
      "string (uuid)"
    ],
    "references": {
      "orders": [
        {
          "id": "string (uuid)",
          "is_inbound": "boolean",
          "is_backordered": "boolean",
          "is_unavailable": "boolean",
          "warehouse": {
            "claim_id": "string (uuid)",
            "route_id": "string (uuid)",
            "is_reservation": "boolean",
            "transfer_id": "string (uuid)"
          },
          "shipments": [
            {
              "id": "string (uuid)",
              "is_inbound": "boolean",
              "is_missing": "boolean"
            }
          ]
        }
      ],
      "backorders": [
        "string (uuid)"
      ]
    },
    "filters": [
      {
        "key": "string",
        "values": [
          "string"
        ]
      }
    ],
    "delivery_routes": [
      {
        "id": "string (uuid)",
        "name": "string"
      }
    ],
    "collect_routes": [
      {
        "id": "string (uuid)",
        "name": "string",
        "delivery_routes": [
          "string"
        ]
      }
    ]
  }
]
Response Headers (200 OK)
x-count

undefined

 string
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:read
OdrItems

Set route

PUT /odr/orders/{id}/items/routing

Define a WMS route for a set of order items

object
item_ids: string[]
string (uuid)
delivery_route_id: string (uuid)
collect_route_id: string (uuid)
id: string
in path

(no description)

Request Example
[
  {
    "item_ids": [
      "string (uuid)"
    ],
    "delivery_route_id": "string (uuid)",
    "collect_route_id": null
  }
]
200 OK
OdrSimpleOrderItem

The list of groups

type
OdrSimpleOrderItem
400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "id": "string",
    "reference": "string",
    "sku": "string",
    "description": "string",
    "is_inbound": "boolean"
  }
]
Response Headers (200 OK)
x-count

undefined

 string
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:write
OdrItems

Set claim

PUT /odr/orders/{id}/items/claim

set an claim on a order item

object
item_id: string (uuid)
claim_id: string (uuid)
claim_item_id: string (uuid)
id: string
in path

(no description)

Request Example
[
  {
    "item_id": "string (uuid)",
    "claim_id": "string (uuid)",
    "claim_item_id": "string (uuid)"
  }
]
200 OK
OdrOrderItem

The list of groups

type
OdrOrderItem
400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "id": "string",
    "reference": "string",
    "sku": "string",
    "description": "string",
    "order_id": "string (uuid)",
    "references": {
      "orders": [
        {
          "id": "string (uuid)",
          "is_inbound": "boolean",
          "is_available": "boolean",
          "is_backorder": "boolean",
          "warehouse": {
            "claimed_at": "string (date-time)",
            "claim_id": "string (uuid)",
            "claim_item_id": "string (uuid)",
            "route_id": "string (uuid)",
            "is_reservation": "boolean",
            "transfer_id": "string (uuid)"
          },
          "shipments": [
            {
              "id": "string (uuid)",
              "is_inbound": "boolean",
              "is_missing": "boolean"
            }
          ],
          "backorders": [
            "string"
          ],
          "target": "string"
        }
      ],
      "stacks": [
        {
          "id": "string",
          "type": "string",
          "state": {
            "is_locked": "boolean",
            "is_accepted": "boolean",
            "is_confirmed": "boolean",
            "is_finished": "boolean"
          }
        }
      ]
    },
    "filters": [
      {
        "key": "string",
        "values": [
          "string"
        ]
      }
    ]
  }
]
Response Headers (200 OK)
x-count

undefined

 string
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:write
OdrItems

Search for items

POST /odr/search/orders/items

Returns a list items

OdrSearch

undefined

x-page: string 1
in header

the requested page id

x-page-size: string 25
in header

the requested page size

Request Example
{
  "constraints": [
    {
      "key": "string",
      "operator": "string",
      "values": [
        "string"
      ]
    }
  ],
  "filters": [
    {
      "key": "string",
      "values": [
        "string"
      ]
    }
  ]
}
200 OK
OdrGroup

The list of groups

type
OdrGroup
400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "sku": "string",
    "reference": "string",
    "description": "string",
    "quantity": "integer",
    "ids": [
      "string (uuid)"
    ],
    "references": {
      "orders": [
        {
          "id": "string (uuid)",
          "is_inbound": "boolean",
          "is_backordered": "boolean",
          "is_unavailable": "boolean",
          "warehouse": {
            "claim_id": "string (uuid)",
            "delivery_route_id": "string (uuid)",
            "collect_route_id": "string (uuid)",
            "is_reservation": "boolean",
            "address_id": "string",
            "transfer_id": "string (uuid)"
          },
          "shipments": [
            {
              "id": "string (uuid)",
              "is_inbound": "boolean",
              "is_missing": "boolean"
            }
          ]
        }
      ],
      "backorders": [
        "string (uuid)"
      ],
      "target": "string"
    },
    "filters": [
      {
        "key": "string",
        "values": [
          "string"
        ]
      }
    ]
  }
]
Response Headers (200 OK)
x-count

undefined

 string
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:read
OdrItems

Search for items with routing

POST /odr/search/orders/items/routing

Returns a list items with routing

OdrSearch

undefined

x-page: string 1
in header

the requested page id

x-page-size: string 25
in header

the requested page size

Request Example
{
  "constraints": [
    {
      "key": "string",
      "operator": "string",
      "values": [
        "string"
      ]
    }
  ],
  "filters": [
    {
      "key": "string",
      "values": [
        "string"
      ]
    }
  ]
}
200 OK
OdrGroupRoute

The list of groups

type
OdrGroupRoute
400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "sku": "string",
    "reference": "string",
    "description": "string",
    "quantity": "integer",
    "order_id": "string (uuid)",
    "ids": [
      "string (uuid)"
    ],
    "references": {
      "orders": [
        {
          "id": "string (uuid)",
          "is_inbound": "boolean",
          "is_backordered": "boolean",
          "is_unavailable": "boolean",
          "warehouse": {
            "claim_id": "string (uuid)",
            "route_id": "string (uuid)",
            "is_reservation": "boolean",
            "transfer_id": "string (uuid)"
          },
          "shipments": [
            {
              "id": "string (uuid)",
              "is_inbound": "boolean",
              "is_missing": "boolean"
            }
          ]
        }
      ],
      "backorders": [
        "string (uuid)"
      ]
    },
    "filters": [
      {
        "key": "string",
        "values": [
          "string"
        ]
      }
    ],
    "delivery_routes": [
      {
        "id": "string (uuid)",
        "name": "string"
      }
    ],
    "collect_routes": [
      {
        "id": "string (uuid)",
        "name": "string",
        "delivery_routes": [
          "string"
        ]
      }
    ]
  }
]
Response Headers (200 OK)
x-count

undefined

 string
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:read
OdrItems

Search for items with routing

POST /odr/search/orders/items/attach

Returns a list items with routing

order: OdrSearch
wms: object
constraints: object[]
object
key: string
operator: string
values: string[]
string
use_referenced_stock: boolean
x-page: string 1
in header

the requested page id

x-page-size: string 25
in header

the requested page size

Request Example
{
  "order": {
    "constraints": [
      {
        "key": "string",
        "operator": "string",
        "values": [
          "string"
        ]
      }
    ],
    "filters": [
      {
        "key": "string",
        "values": [
          "string"
        ]
      }
    ]
  },
  "wms": {
    "constraints": [
      {
        "key": "string",
        "operator": "string",
        "values": [
          "string"
        ]
      }
    ],
    "use_referenced_stock": "boolean"
  }
}
200 OK
OdrGroupAttach

The list of groups

type
OdrGroupAttach
400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "sku": "string",
    "reference": "string",
    "description": "string",
    "quantity": "integer",
    "order_id": "string (uuid)",
    "ids": [
      "string (uuid)"
    ],
    "references": {
      "orders": [
        {
          "id": "string (uuid)",
          "is_inbound": "boolean",
          "is_backordered": "boolean",
          "is_unavailable": "boolean",
          "warehouse": {
            "claim_id": "string (uuid)",
            "route_id": "string (uuid)",
            "is_reservation": "boolean",
            "transfer_id": "string (uuid)"
          },
          "shipments": [
            {
              "id": "string (uuid)",
              "is_inbound": "boolean",
              "is_missing": "boolean"
            }
          ]
        }
      ],
      "backorders": [
        "string (uuid)"
      ]
    },
    "filters": [
      {
        "key": "string",
        "values": [
          "string"
        ]
      }
    ],
    "inventory_item_ids": [
      "string (uuid)"
    ],
    "available": "number"
  }
]
Response Headers (200 OK)
x-count

undefined

 string
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:read

OdrSearch

OdrSearch

Search for orders

POST /odr/search/orders

Search orders by id

OdrOrderSearch

undefined

Request Example
{
  "constraints": [
    {
      "key": "string",
      "operator": "string",
      "values": [
        "string"
      ]
    }
  ]
}
200 OK
OdrOrder

All matching orders

type
OdrOrder
400 Bad Request
Error

Bad request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "id": "string (uuid)",
    "number": "string",
    "state": {
      "is_locked": "boolean",
      "is_accepted": "boolean",
      "is_confirmed": "boolean",
      "is_finished": "boolean",
      "is_canceled": "boolean",
      "type": "string",
      "flow": [
        {
          "code": "string",
          "order": "integer",
          "is_reversible": "boolean",
          "trigger": "string",
          "actions": [
            {
              "code": "string",
              "order": "integer",
              "label": "string",
              "is_handled": "boolean",
              "handled_at": "string (date-time)"
            }
          ]
        }
      ],
      "progress": {
        "allocation": "string",
        "fulfilment": "string",
        "billing": "string"
      }
    },
    "settings": {
      "contact": {
        "id": "string (uuid)",
        "version": "string (uuid)"
      },
      "organisation": {
        "id": "string (uuid)",
        "version": "string (uuid)"
      },
      "phone_number_id": "string (uuid)",
      "coupons": [
        "string"
      ],
      "due_at": "string (date)",
      "return_url": "string",
      "billing": {
        "address_id": "string (uuid)",
        "method_code": "string",
        "issuer_code": "string",
        "provider_code": "string"
      },
      "shipping": {
        "address_id": "string (uuid)",
        "source_address_id": "string (uuid)",
        "method_id": "string (uuid)",
        "spid": "string",
        "window": {
          "from": "integer",
          "to": "integer",
          "delivery_at": "string (date)",
          "code": "string"
        },
        "is_split_allowed": "boolean"
      }
    },
    "processing": {
      "confirm": "string",
      "allocation": "string",
      "fulfilment": "string",
      "capture": "string"
    },
    "acceptances": [
      {
        "id": "string (uuid)",
        "amount": "integer",
        "is_prepaid": "boolean",
        "is_settlement": "boolean",
        "is_paid": "boolean",
        "calculation_id": "string (uuid)",
        "transaction_secret": "string",
        "created_at": "string (date-time)",
        "accepted_at": "string (date-time)"
      }
    ],
    "calculations": [
      {
        "id": "string (uuid)",
        "reference": "string",
        "currency": "string",
        "client_id": "string (uuid)",
        "amount": "integer",
        "is_valid": "boolean",
        "is_accepted": "boolean",
        "is_confirmed": "boolean",
        "expires_at": "string (date-time)"
      }
    ],
    "client_id": "string",
    "tags": [
      "string"
    ],
    "stack_id": "string",
    "type": "string",
    "last_accepted_at": "string (date-time)",
    "last_confirmed_at": "string (date-time)",
    "last_canceled_at": "string (date-time)",
    "created_at": "string (date-time)",
    "updated_at": "string (date-time)"
  }
]
Response Headers (200 OK)
x-count

undefined

 string
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:orders:read
OdrSearch

Search calculations

POST /odr/search/calculations

Search calculations by id

OdrCalculationSearch

undefined

Request Example
{
  "constraints": [
    {
      "key": "string",
      "operator": "string",
      "values": [
        "string"
      ]
    }
  ]
}
200 OK
OdrCalculation

All matching valid calculations

type
OdrCalculation
400 Bad Request
Error

Bad request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "id": "string",
    "number": "string",
    "reference": "string",
    "items": [
      {
        "id": "string",
        "reference": "string",
        "sku": "string",
        "description": "string",
        "type": "string",
        "amount": "integer",
        "is_discounted": "boolean",
        "quantity": "integer",
        "subtotal": "integer",
        "adjustments": [
          {
            "reference": "string",
            "description": "string",
            "amount": "number",
            "is_percentage": "boolean",
            "is_discount": "boolean",
            "result": {
              "is_applied_rule": "boolean",
              "rule_id": "string",
              "output": "integer"
            }
          }
        ],
        "vat_percentage": "integer",
        "total": "integer",
        "total_revenue": "integer",
        "order_items": [
          {
            "id": "string",
            "is_invoiced": "boolean",
            "invoice_id": "string"
          }
        ]
      }
    ],
    "services": [
      {
        "description": "string",
        "type": "string",
        "amount": "number",
        "is_percentage": "boolean",
        "quantity": "integer",
        "subtotal": "integer",
        "adjustments": [
          {
            "reference": "string",
            "description": "string",
            "amount": "number",
            "is_percentage": "boolean",
            "is_discount": "boolean",
            "result": {
              "is_applied_rule": "boolean",
              "rule_id": "string (uuid)",
              "output": "integer"
            }
          }
        ],
        "vat_percentage": "integer",
        "total": "integer"
      }
    ],
    "subtotal": "integer",
    "adjustments": [
      {
        "reference": "string",
        "description": "string",
        "amount": "number",
        "is_percentage": "boolean",
        "is_discount": "boolean",
        "result": {
          "is_applied_rule": "boolean",
          "rule_id": "string",
          "output": "integer"
        }
      }
    ],
    "total": "integer",
    "vat": [
      {
        "rate": "integer",
        "amount": "integer"
      }
    ],
    "currency": "string",
    "customer": {
      "vat_country_code": "string",
      "contact": {
        "email": "string",
        "vat_number": "string",
        "coc_number": "string",
        "organisation_id": "string",
        "organisation_version": "string",
        "address_id": "string",
        "phone_number_id": "string",
        "id": "string",
        "version": "string"
      }
    },
    "vendor": {
      "vat_country_code": "string",
      "contact": {
        "email": "string",
        "vat_number": "string",
        "coc_number": "string",
        "organisation_id": "string",
        "organisation_version": "string",
        "address_id": "string",
        "phone_number_id": "string",
        "id": "string",
        "version": "string"
      }
    },
    "is_including_vat": "boolean",
    "is_vat_shifted": "boolean",
    "is_prepaid": "boolean",
    "is_invoiced": "boolean",
    "client_id": "string",
    "file_id": "string",
    "metadata": "object",
    "pricing_at": "string (date-time)",
    "created_at": "string (date-time)",
    "updated_at": "string (date-time)"
  }
]
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:invoices:read
OdrSearch

Search invoices

POST /odr/search/invoices

Search invoices by ID

OdrInvoiceSearch

undefined

Request Example
{
  "constraints": [
    {
      "key": "string",
      "operator": "string",
      "values": [
        "string"
      ]
    }
  ]
}
200 OK
OdrInvoice

All matching invoices

type
OdrInvoice
400 Bad Request
Error

Bad request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "id": "string",
    "number": "string",
    "reference": "string",
    "items": [
      {
        "sku": "string",
        "description": "string",
        "type": "string",
        "amount": "integer",
        "is_discounted": "boolean",
        "quantity": "integer",
        "subtotal": "integer",
        "adjustments": [
          {
            "reference": "string",
            "description": "string",
            "amount": "number",
            "is_percentage": "boolean",
            "is_discount": "boolean",
            "result": {
              "output": "integer"
            }
          }
        ],
        "vat_percentage": "integer",
        "total": "integer",
        "total_revenue": "integer",
        "order_items": [
          {
            "id": "string",
            "is_invoiced": "boolean",
            "invoice_id": "string"
          }
        ]
      }
    ],
    "services": [
      {
        "description": "string",
        "type": "string",
        "amount": "number",
        "is_percentage": "boolean",
        "quantity": "integer",
        "subtotal": "integer",
        "adjustments": [
          {
            "reference": "string",
            "description": "string",
            "amount": "number",
            "is_percentage": "boolean",
            "is_discount": "boolean",
            "result": {
              "is_applied_rule": "boolean",
              "rule_id": "string (uuid)",
              "output": "integer"
            }
          }
        ],
        "vat_percentage": "integer",
        "total": "integer"
      }
    ],
    "subtotal": "integer",
    "adjustments": [
      {
        "reference": "string",
        "description": "string",
        "amount": "number",
        "is_percentage": "boolean",
        "is_discount": "boolean",
        "result": {
          "output": "integer"
        }
      }
    ],
    "total": "integer",
    "vat": [
      {
        "rate": "integer",
        "amount": "integer"
      }
    ],
    "currency": "string",
    "customer": {
      "vat_country_code": "string",
      "contact": {
        "email": "string",
        "vat_number": "string",
        "coc_number": "string",
        "organisation_id": "string",
        "organisation_version": "string",
        "address_id": "string",
        "phone_number_id": "string",
        "id": "string",
        "version": "string"
      }
    },
    "vendor": {
      "vat_country_code": "string",
      "contact": {
        "email": "string",
        "vat_number": "string",
        "coc_number": "string",
        "organisation_id": "string",
        "organisation_version": "string",
        "address_id": "string",
        "phone_number_id": "string",
        "id": "string",
        "version": "string"
      }
    },
    "is_including_vat": "boolean",
    "is_vat_shifted": "boolean",
    "is_paid": "boolean",
    "client_id": "string",
    "file_id": "string",
    "metadata": "object",
    "pricing_at": "string (date-time)",
    "paid_at": "string (date-time)",
    "order_ids": [
      "string (uuid)"
    ],
    "coupons": [
      "string (uuid)"
    ],
    "calculation_id": "string (uuid)",
    "shipment_id": "string (uuid)",
    "created_at": "string (date-time)",
    "updated_at": "string (date-time)"
  }
]
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:invoices:read
OdrSearch

Search coupons

POST /odr/search/coupons

Search coupons by code

OdrCouponSearch

undefined

Request Example
{
  "constraints": [
    {
      "key": "string",
      "operator": "string",
      "values": [
        "string"
      ]
    }
  ]
}
200 OK
OdrCoupon

All matching coupons

type
OdrCoupon
400 Bad Request
Error

Bad request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "code": "string",
    "usage": {
      "is_unlimited": "boolean",
      "remaining": "integer"
    },
    "category_id": "string (uuid)",
    "claims": [
      {
        "order_id": "string (uuid)",
        "is_confirmed": "boolean"
      }
    ],
    "expires_at": "string (date-time)",
    "created_at": "string (date-time)"
  }
]
Response Headers (200 OK)
x-count

undefined

 string
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:coupons:read
OdrSearch

Search coupon categories

POST /odr/search/coupons/categories

Search coupon categories by id

OdrCouponCategorySearch

undefined

Request Example
{
  "constraints": [
    {
      "key": "string",
      "operator": "string",
      "values": [
        "string"
      ]
    }
  ]
}
200 OK
OdrCouponCategory

All matching coupon categories

type
OdrCouponCategory
400 Bad Request
Error

Bad request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "id": "string (uuid)",
    "name": "string",
    "defaults": {
      "expires_after": "integer",
      "usage": {
        "is_unlimited": "boolean",
        "limit": "integer"
      }
    },
    "created_at": "string (date-time)",
    "updated_at": "string (date-time)"
  }
]
Response Headers (200 OK)
x-count

undefined

 string
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:coupons:read

OdrSkus

OdrSkus

Announce a set of skus

POST /odr/skus

Provide the service with a set of valid skus

OdrSku
Request Example
[
  {
    "sku": "string",
    "description": "string",
    "expires_at": "string (date-time)"
  }
]
200 OK
OdrSkuResult

The list of skus

400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
{
  "status": "string",
  "count": "integer"
}
Response Example (400 Bad Request) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (401 Unauthorized) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (403 Forbidden) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (404 Not Found) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (500 Internal Server Error) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Response Example (503 Service Unavailable) 
{
  "code": "integer",
  "message": "string",
  "reference": "string",
  "errors": {
    "invalid value": [
      "property1"
    ],
    "required": [
      "property2"
    ]
  }
}
Bearer odr:skus:write

OdrFilters

OdrFilters

Search filters

POST /odr/search/filters

Returns a list of filters

OdrFilterSearch

undefined

x-page: string 1
in header

the requested page id

x-page-size: string 25
in header

the requested page size

Request Example
{
  "constraints": [
    {
      "key": "string",
      "operator": "string",
      "values": [
        "string"
      ]
    }
  ]
}
200 OK
OdrFilterSet

The list of groups

type
OdrFilterSet
400 Bad Request
Error

Bad Request

401 Unauthorized
Error

Unauthorized

403 Forbidden
Error

Forbidden

404 Not Found
Error

Not found

500 Internal Server Error
Error

Internal Server Error

503 Service Unavailable
Error

Service Unavailable

Response Example (200 OK) 
[
  {
    "sku": "string",
    "filters": "object"
  }
]
Response Headers (200 OK)