Skip to main content
GET
Obtener detalle de una venta
Returns one sale by id. Use GET /v1/ecommerce/sales to find the id, or take it from an ecommerce.sale.* webhook.

Endpoint

Required scope

ecommerce:sales:read

Headers

Path parameters

Example request

Response

200 OK

401 Unauthorized

Missing, invalid, revoked, or expired token.

403 Forbidden

The token does not have the ecommerce:sales:read scope.

404 Not Found

No sale with that id, or it belongs to a different company.

502 Bad Gateway

The ecommerce service could not answer.

Operational notes

  • The id is the ObjectId, not the sale_number. Passing 1042 returns 400.
  • A sale mixes item kinds. product, service, and custom line items live in the same items array, and the amounts block breaks the subtotals out by kind so you can split revenue without re-adding them yourself.
  • payment_status: "partially_paid" means money is still owed. paid_at is the timestamp of the first payment, not of settlement — compare amounts.total against your own ledger if you need the outstanding balance.
  • customer_id is the CRM customer; chat_user_id is the contact. They are different records and either can be absent.

Authorizations

Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Path Parameters

id
string
required

Response

200 - application/json
sale
object
required