Sales

List Sales

get

Autorizações

authX-Zydon-Access-Key-TokenX-Zydon-Access-Key-Code

AuthorizationstringObrigatório

Bearer authentication header of the form Bearer <token>.

Parâmetros de consulta

searchstringOpcionalDefault: ""

pageinteger · int32OpcionalDefault: 0

perPageinteger · int32OpcionalDefault: 25

sortstringOpcionalDefault: id

dirstringOpcionalDefault: asc

partner_idstringOpcional

start_datestring · date-timeOpcional

final_datestring · date-timeOpcional

quotationbooleanOpcional

Respostas

200

OK

application/json

currentPageinteger · int32Opcional

perPageinteger · int32Opcional

totalinteger · int64Opcional

404

Sales was not found

application/json

500

An internal server error was thrown

application/json

get

/sales

HTTPcURLJavaScriptPython

GET /api/sales/sales HTTP/1.1
Host: api.zydon.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "currentPage": 1,
  "perPage": 1,
  "total": 1,
  "items": [
    {
      "id": "text",
      "company_id": "text",
      "external_id": "text",
      "partner_id": "text",
      "partner_name": "text",
      "total_value": 1,
      "items_quantity": 1,
      "origin_id": "text",
      "origin_name": "text",
      "origin": {
        "id": "text",
        "name": "text",
        "metadata": {
          "ANY_ADDITIONAL_PROPERTY": {}
        },
        "attributes": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      },
      "created_at": "2026-02-19T16:45:29.946Z",
      "payments": [
        {
          "id": "text",
          "name": "text"
        }
      ],
      "status": {
        "id": "text",
        "status_id": "text",
        "title": "text",
        "background_color": "text",
        "font_color": "text"
      },
      "webhook_error": "text",
      "quotation": true
    }
  ]
}

Create a new sale

post

Autorizações

authX-Zydon-Access-Key-TokenX-Zydon-Access-Key-Code

AuthorizationstringObrigatório

Bearer authentication header of the form Bearer <token>.

Corpo

application/json

external_idstringOpcional

company_idstringOpcional

total_valuenumberObrigatório

full_valuenumberObrigatório

partner_idstringObrigatório

seller_idstringOpcional

observationstringOpcional

invoicesstring[]Opcional

created_atstring · date-timeObrigatório

updated_bystringObrigatório

shopping_cart_idstringOpcional

quotationbooleanOpcional

Respostas

200

OK

application/json

idstringOpcional

external_idstringOpcional

organization_idstringOpcional

company_idstringOpcional

total_valuenumberOpcional

full_valuenumberOpcional

partner_idstringOpcional

seller_idstringOpcional

created_atstring · date-timeOpcional

updated_bystringOpcional

total_discountnumberOpcional

invoicesstring[]Opcional

quotationbooleanOpcional

400

Cannot create sale

application/json

500

An internal server error was thrown

application/json

post

/sales

HTTPcURLJavaScriptPython

POST /api/sales/sales HTTP/1.1
Host: api.zydon.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1598

{
  "external_id": "text",
  "company_id": "text",
  "total_value": 1,
  "full_value": 1,
  "partner_id": "text",
  "seller_id": "text",
  "observation": "text",
  "invoices": [
    "text"
  ],
  "created_at": "2026-02-19T16:45:29.946Z",
  "updated_by": "text",
  "origin": {
    "solution_id": "text",
    "attributes": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "items": [
    {
      "product_id": "text",
      "quantity": 1,
      "unit": "text",
      "unit_value": 1,
      "discount": 1,
      "total_value": 1,
      "item_origin_value": "text",
      "item_origin_type": "text",
      "product_variation_id": "text",
      "automation_fields": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "complements": [
        {
          "product_complement_id": "text",
          "product_complement_option_id": "text",
          "product_complement_option_key": "text",
          "key": "text",
          "title": "text",
          "type": "text",
          "value_paid": 1,
          "selected_value": "text"
        }
      ]
    }
  ],
  "freight": {
    "amount": 1
  },
  "discount": [
    {
      "type": "text",
      "amount": 1
    }
  ],
  "payments": [
    {
      "payment_method_id": "text",
      "amount": 1,
      "installments": 1,
      "installment_id": "text",
      "transaction_id": "text"
    }
  ],
  "pre_order_complement": {
    "ANY_ADDITIONAL_PROPERTY": {}
  },
  "checkout_complement": {
    "ANY_ADDITIONAL_PROPERTY": {}
  },
  "automation_fields": {
    "ANY_ADDITIONAL_PROPERTY": {}
  },
  "resume_fields": {
    "ANY_ADDITIONAL_PROPERTY": {}
  },
  "delivery": {
    "id": "text",
    "delivery_method_id": "text",
    "delivery_rule_id": "text",
    "delivery_date": "text",
    "delivery_scheduling_id": "text",
    "delivery_method_period_start": "text",
    "delivery_method_period_end": "text",
    "delivery_method_period_type": "text",
    "delivery_method_type": "text",
    "delivery_method_name": "text"
  },
  "coupons": [
    {
      "coupon_id": "text",
      "attributes": {
        "ANY_ADDITIONAL_PROPERTY": {}
      }
    }
  ],
  "email_config": {
    "ANY_ADDITIONAL_PROPERTY": {}
  },
  "shopping_cart_id": "text",
  "quotation": true
}

{
  "id": "text",
  "external_id": "text",
  "organization_id": "text",
  "company_id": "text",
  "total_value": 1,
  "full_value": 1,
  "partner_id": "text",
  "seller_id": "text",
  "created_at": "2026-02-19T16:45:29.946Z",
  "updated_by": "text",
  "total_discount": 1,
  "invoices": [
    "text"
  ],
  "origin": {
    "origin_id": "text",
    "attributes": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "items": [
    {
      "id": "text",
      "product_id": "text",
      "product_name": "text",
      "quantity": 1,
      "unit": "text",
      "unit_value": 1,
      "discount": 1,
      "total_value": 1,
      "item_origin_value": "text",
      "item_origin_type": "text",
      "product_variation_id": "text"
    }
  ],
  "freight": {
    "id": "text",
    "amount": 1
  },
  "discount": [
    {
      "id": "text",
      "type": "text",
      "amount": 1
    }
  ],
  "payments": [
    {
      "id": "text",
      "payment_method_id": "text",
      "payment_method_name": "text",
      "payment_method_type": "CREDIT_CARD",
      "amount": 1,
      "installments": 1
    }
  ],
  "pre_order_complement": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "checkout_complement": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "automation_fields": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "delivery": {
    "address_type": "text",
    "street": "text",
    "number": "text",
    "complement": "text",
    "neighborhood": "text",
    "city": "text",
    "state": "text",
    "postal_code": "text",
    "country": "text",
    "contact_name": "text",
    "contact_number": "text"
  },
  "quotation": true
}

Get sale

get

Autorizações

authX-Zydon-Access-Key-TokenX-Zydon-Access-Key-Code

AuthorizationstringObrigatório

Bearer authentication header of the form Bearer <token>.

Parâmetros de rota

idstringObrigatório

Respostas

200

OK

application/json

idstringOpcional

organization_idstringOpcional

external_idstringOpcional

total_valuenumberOpcional

full_valuenumberOpcional

observationstringOpcional

invoicesstring[]Opcional

created_atstring · date-timeOpcional

updated_bystringOpcional

total_discountnumberOpcional

webhook_errorstringOpcional

quotationbooleanOpcional

delivery_method_idstringOpcional

delivery_rule_idstringOpcional

delivery_datestringOpcional

delivery_scheduling_idstringOpcional

delivery_method_period_startstringOpcional

delivery_method_period_endstringOpcional

delivery_method_period_typestringOpcional

delivery_method_typestringOpcional

delivery_method_namestringOpcional

404

Sales was not found

application/json

500

An internal server error was thrown

application/json

get

/sales/{id}

HTTPcURLJavaScriptPython

GET /api/sales/sales/{id} HTTP/1.1
Host: api.zydon.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "organization_id": "text",
  "company": {
    "id": "text",
    "name": "text",
    "fiscal_registration_number": "text"
  },
  "external_id": "text",
  "total_value": 1,
  "full_value": 1,
  "observation": "text",
  "partner": {
    "id": "text",
    "name": "text",
    "phone": "text",
    "mobile": "text",
    "fiscal_registration_number": "text",
    "email": "text"
  },
  "seller": {
    "id": "text",
    "name": "text"
  },
  "invoices": [
    "text"
  ],
  "created_at": "2026-02-19T16:45:29.946Z",
  "updated_by": "text",
  "total_discount": 1,
  "origin": {
    "id": "text",
    "name": "text",
    "metadata": {
      "ANY_ADDITIONAL_PROPERTY": {}
    },
    "attributes": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "items": [
    {
      "id": "text",
      "product_id": "text",
      "product_name": "text",
      "quantity": 1,
      "unit_id": "text",
      "unit": "text",
      "unit_value": 1,
      "discount": 1,
      "total_value": 1,
      "item_origin_value": "text",
      "item_origin_type": "text",
      "product_variation_id": "text",
      "product_image": "text",
      "complements": [
        {
          "id": "text",
          "product_complement_id": "text",
          "product_complement_option_id": "text",
          "product_complement_option_key": "text",
          "key": "text",
          "title": "text",
          "type": "text",
          "value_paid": 1,
          "selected_value": "text"
        }
      ]
    }
  ],
  "freight": {
    "id": "text",
    "amount": 1
  },
  "discount": [
    {
      "id": "text",
      "type": "text",
      "amount": 1
    }
  ],
  "payments": [
    {
      "id": "text",
      "payment_method_id": "text",
      "payment_method_name": "text",
      "payment_method_type": "CREDIT_CARD",
      "amount": 1,
      "installments": 1,
      "card": {
        "financial_id": "text",
        "brand": "text",
        "number": "text",
        "expiration_month": "text",
        "expiration_year": "text",
        "nsu": "text",
        "tid": "text",
        "created_by": "123e4567-e89b-12d3-a456-426614174000",
        "created_at": "2026-02-19T16:45:29.946Z",
        "updated_by": "123e4567-e89b-12d3-a456-426614174000",
        "updated_at": "2026-02-19T16:45:29.946Z"
      },
      "pix": {
        "financial_id": "text",
        "qr_code": "text",
        "resource_file_id": "text",
        "created_by": "123e4567-e89b-12d3-a456-426614174000",
        "created_at": "2026-02-19T16:45:29.946Z",
        "updated_by": "123e4567-e89b-12d3-a456-426614174000",
        "updated_at": "2026-02-19T16:45:29.946Z"
      },
      "payment_billet": {
        "financial_id": "text",
        "bar_code": "text",
        "qr_code": "text",
        "resource_file_id": "text",
        "created_by": "123e4567-e89b-12d3-a456-426614174000",
        "created_at": "2026-02-19T16:45:29.946Z",
        "updated_by": "123e4567-e89b-12d3-a456-426614174000",
        "updated_at": "2026-02-19T16:45:29.946Z"
      }
    }
  ],
  "pre_order_complement": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "checkout_complement": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "automation_fields": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "delivery": {
    "address_type": "text",
    "street": "text",
    "number": "text",
    "complement": "text",
    "neighborhood": "text",
    "city": "text",
    "state": "text",
    "postal_code": "text",
    "country": "text",
    "contact_name": "text",
    "contact_number": "text"
  },
  "statuses": [
    {
      "id": "text",
      "status_id": "text",
      "created_at": "2026-02-19T16:45:29.946Z"
    }
  ],
  "webhook_error": "text",
  "quotation": true,
  "delivery_method_id": "text",
  "delivery_rule_id": "text",
  "delivery_date": "text",
  "delivery_scheduling_id": "text",
  "delivery_method_period_start": "text",
  "delivery_method_period_end": "text",
  "delivery_method_period_type": "text",
  "delivery_method_type": "text",
  "delivery_method_name": "text"
}