API de vendas

Pedido, fulfill, cancelamento, agrupamento, Pedido Rápido e headers de tenant.

Prefixo /sales-order. Headers: Authorization, x-company-id, x-filial-id.

Pedido

MétodoRota
POST/sales-order
GET/sales-order/:filialId
GET/sales-order/:id
PATCH/sales-order/:id
DELETE/sales-order/:id
POST/sales-order/:id/assign-customer
POST/sales-order/group e /group/preview
GET/sales-order/:id/fulfillment
POST/sales-order/:id/fulfill
POST/sales-order/convert-quote/:salesOrderId
POST/sales-order/convert-order-to-quote/:salesOrderId
GET/sales-order/cancel-preview/:salesOrderId
POST/sales-order/cancel/:salesOrderId

Listagem: código numérico por igualdade/prefixo; texto resolve cliente (LIMIT 250) e filtra customer_id + vendedor/alias. Paginação em duas fases.

Pedido Rápido

GET / PUT /quick-sale/configuration/:filialId
GET /quick-sale/validate-configuration/:filialId

Create continua em POST /sales-order com flowMode: "QUICK_SALE".

curl — faturar

curl -s -X POST "$API/sales-order/$ORDER_ID/fulfill" \
  -H "Authorization: Bearer $TOKEN" \
  -H "x-company-id: $COMPANY" -H "x-filial-id: $FILIAL" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"salesOrderItemId":"<hashid>","quantity":4500}]}'

Devolução

GET /returns/returnable-items/:filialId?customerId=
POST /returns/:filialId

SDK

ctx.m3r.sales — get, find, create, fulfill. IPs: lista. Eventos: eventos.