biterp

List sales orders

GET
/sales-orders
AuthorizationBearer <token>

In: header

Query Parameters

cursor?string

Opaque cursor from CursorPaginationDto.cursor. Use next_cursor or previous_cursor from the previous response.

limit?integer

Page size from CursorPaginationDto.limit.

Default20
Range1 <= value <= 100
search?string

Full-text search term from CursorPaginationDto.search.

with_deleted?boolean

Include soft-deleted records from CursorPaginationDto.with_deleted.

Defaultfalse
include_payload_search?boolean

Include payload JSON search from CursorPaginationDto.include_payload_search when supported by the endpoint.

Defaultfalse
sort?string

Sort expression from CursorPaginationDto.sort in the format field:order (for example created_at:desc).

reference_code?string

Exact match for "reference_code" (string)

reference_code[neq]?string

Not equal filter for "reference_code" (string)

reference_code[contains]?string

Contains filter for "reference_code"

reference_code[not_contains]?string

Does not contain filter for "reference_code"

operation_type?string

Exact match for "operation_type" (string)

operation_type[neq]?string

Not equal filter for "operation_type" (string)

operation_type[contains]?string

Contains filter for "operation_type"

operation_type[not_contains]?string

Does not contain filter for "operation_type"

product_type?string

Exact match for "product_type" (string)

product_type[neq]?string

Not equal filter for "product_type" (string)

product_type[contains]?string

Contains filter for "product_type"

product_type[not_contains]?string

Does not contain filter for "product_type"

status?string

Exact match for "status" (string)

status[neq]?string

Not equal filter for "status" (string)

status[contains]?string

Contains filter for "status"

status[not_contains]?string

Does not contain filter for "status"

order_date?string

Exact match for "order_date" (ISO 8601 date (YYYY-MM-DD))

order_date[neq]?string

Not equal filter for "order_date" (ISO 8601 date (YYYY-MM-DD))

order_date[gt]?string

Greater than filter for "order_date" (ISO 8601 date (YYYY-MM-DD))

order_date[gte]?string

Greater than or equal filter for "order_date" (ISO 8601 date (YYYY-MM-DD))

order_date[lt]?string

Less than filter for "order_date" (ISO 8601 date (YYYY-MM-DD))

order_date[lte]?string

Less than or equal filter for "order_date" (ISO 8601 date (YYYY-MM-DD))

delivery_date?string

Exact match for "delivery_date" (ISO 8601 date (YYYY-MM-DD))

delivery_date[neq]?string

Not equal filter for "delivery_date" (ISO 8601 date (YYYY-MM-DD))

delivery_date[gt]?string

Greater than filter for "delivery_date" (ISO 8601 date (YYYY-MM-DD))

delivery_date[gte]?string

Greater than or equal filter for "delivery_date" (ISO 8601 date (YYYY-MM-DD))

delivery_date[lt]?string

Less than filter for "delivery_date" (ISO 8601 date (YYYY-MM-DD))

delivery_date[lte]?string

Less than or equal filter for "delivery_date" (ISO 8601 date (YYYY-MM-DD))

customer_id?string

Exact match for "customer_id" (UUID)

Formatuuid
customer_id[neq]?string

Not equal filter for "customer_id" (UUID)

Formatuuid
quote_id?string

Exact match for "quote_id" (UUID)

Formatuuid
quote_id[neq]?string

Not equal filter for "quote_id" (UUID)

Formatuuid
salesperson_name?string

Exact match for "salesperson_name" (string)

salesperson_name[neq]?string

Not equal filter for "salesperson_name" (string)

salesperson_name[contains]?string

Contains filter for "salesperson_name"

salesperson_name[not_contains]?string

Does not contain filter for "salesperson_name"

created_at?string

Exact match for "created_at" (ISO 8601 datetime)

created_at[neq]?string

Not equal filter for "created_at" (ISO 8601 datetime)

created_at[gt]?string

Greater than filter for "created_at" (ISO 8601 datetime)

created_at[gte]?string

Greater than or equal filter for "created_at" (ISO 8601 datetime)

created_at[lt]?string

Less than filter for "created_at" (ISO 8601 datetime)

created_at[lte]?string

Less than or equal filter for "created_at" (ISO 8601 datetime)

updated_at?string

Exact match for "updated_at" (ISO 8601 datetime)

updated_at[neq]?string

Not equal filter for "updated_at" (ISO 8601 datetime)

updated_at[gt]?string

Greater than filter for "updated_at" (ISO 8601 datetime)

updated_at[gte]?string

Greater than or equal filter for "updated_at" (ISO 8601 datetime)

updated_at[lt]?string

Less than filter for "updated_at" (ISO 8601 datetime)

updated_at[lte]?string

Less than or equal filter for "updated_at" (ISO 8601 datetime)

has_active_invoice?boolean

Exact match for "has_active_invoice" (boolean)

has_active_invoice[neq]?boolean

Not equal filter for "has_active_invoice" (boolean)

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api.biterp.ai/sales-orders"
{
  "data": [
    {
      "id": "string",
      "reference_code": "string",
      "operation_type": "sale",
      "product_type": "goods",
      "status": "draft",
      "order_date": "2019-08-24",
      "delivery_date": "2019-08-24",
      "customer_id": "string",
      "quote_id": "3c071a1d-db86-46a7-9dc8-72ba3fbca992",
      "salesperson_name": "string",
      "description": "string",
      "notes": "string",
      "subtotal": "1500.000000",
      "items_discount": "0.000000",
      "discount_amount": "0.000000",
      "discount_rate": "10.000000",
      "total_discount": "0.000000",
      "total": "1500.000000",
      "metadata": {},
      "br_data": {
        "taxation_type": "string"
      },
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "customer": {
        "id": "string",
        "legal_name": "string",
        "trade_name": "string",
        "tax_id": "string"
      },
      "items": [
        {
          "id": "string",
          "sales_order_id": "string",
          "product_id": "string",
          "item_description": "string",
          "quantity": "2.000000",
          "unit_price": "100.000000",
          "discount_amount": "0.000000",
          "subtotal": "200.000000",
          "total": "200.000000",
          "position": 0,
          "created_at": "2019-08-24T14:15:22Z",
          "updated_at": "2019-08-24T14:15:22Z",
          "product": {
            "id": "string",
            "name": "string",
            "reference_code": "string",
            "br_data": {
              "ncm_code": "string",
              "cest_code": "string",
              "origin": "string",
              "extipi": "string",
              "ibs_cbs_cst": "string",
              "ibs_cbs_classification": "string",
              "ibs_cbs_operation_indicator_code": "string",
              "ibs_cbs_is_personal_use": true
            },
            "us_data": {
              "hts_code": "string",
              "schedule_b_code": "string",
              "eccn_code": "string",
              "tax_code": "string",
              "sales_tax_category": "string",
              "country_of_origin": "string",
              "upc_code": "string"
            }
          }
        }
      ],
      "receivables": [
        {
          "id": "string",
          "reference_code": "string",
          "status": "string",
          "amount": "1500.000000",
          "due_date": "2019-08-24",
          "paid_at": "2019-08-24T14:15:22Z",
          "payment_method_id": "ec18d2d7-d2e0-41e4-98e4-847f14422d8a",
          "financial_account_id": "12004dd2-b67b-4561-b5c8-278b86c292fd",
          "installment_number": 0,
          "installment_count": 0,
          "description": "string"
        }
      ],
      "has_active_receivables": true
    }
  ],
  "pagination": {
    "limit": 0,
    "has_next_page": true,
    "has_previous_page": true,
    "current_query_cursor": "string",
    "current_page_cursor": "string",
    "next_cursor": "string",
    "previous_cursor": "string"
  },
  "meta": {
    "filters": {},
    "search": "string",
    "sort": {
      "field": "string",
      "order": "asc"
    }
  }
}
{
  "statusCode": 404,
  "message": "Customer not found",
  "error": "Not Found",
  "code": "CUSTOMER_NOT_FOUND"
}
{
  "statusCode": 404,
  "message": "Customer not found",
  "error": "Not Found",
  "code": "CUSTOMER_NOT_FOUND"
}
{
  "statusCode": 404,
  "message": "Customer not found",
  "error": "Not Found",
  "code": "CUSTOMER_NOT_FOUND"
}