Sensio API
  1. Sales
Sensio API
  • Introdução
  • People
    • Buscar pessoas cadastradas
      GET
    • Cadastrar uma nova pessoa
      POST
    • Encontrar pessoa pelo Id
      GET
  • Items
    • Cadastrar um novo item
      POST
    • Retorna uma lista de itens
      GET
    • Retorna um item específico
      GET
    • Editar item
      POST
    • Retorna as composições do item e/ou das variações
      GET
  • POs
    • Retorna todas as ordens de produção
      GET
    • Retorna uma ordem de produção específica
      GET
    • Retorna uma ordem de produção específica buscando pelo código
      GET
    • Alterar estágio de OP
      PUT
    • Retorna estágios de produção
      GET
    • Criar uma OP
      POST
    • Listar estágios do kanban de OPs
      GET
  • Sales
    • Listar pedidos
      GET
    • Retorna todas as vendas
      GET
    • Retorna um pedido específico
      GET
    • Retorna um pedido específico, buscando pelo código
      GET
    • Cadastrar um novo pedido
      POST
    • Cancelar um pedido
      PUT
    • Faturar um pedido
      PUT
    • Editar estágio de um pedido
      PUT
    • Listar estágios do kanban de pedidos
      GET
  • NFes
    • Lista as NFes
    • Retorna uma NFe específica
    • Retorna XML da NFe
    • Retorna DANFE da NFe
  • NFSes
    • Lista Notas Fiscais de Serviço
    • Retorna uma NFSe por id
    • Retorna XML da NFSe
    • Retorna PDF da NFSe
  • Transactions
    • Quitar lançamento financeiro
    • Cadastrar um novo lançamento financeiro
    • Retorna lançamentos paginados
    • Retorna um lançamento específico
  • Item Categories
    • Listar categorias de itens
  • Warehouses
    • Lista os depósitos
  • Custom Fields
    • Listar Campos Personalizados
  • Batches
    • Retorna lotes de um item
    • Listar lotes
  • Webhooks
    • Configurar webhook
  • Services
    • Retorna serviços cadastrados
  • Accounting
    • Retorna contas contábeis
  • CTes
    • Retorna CTes
    • Retorna CTe pelo id
  • Cargos
    • Editar o status de uma carga
    • Criar uma carga
    • Listar cargas
    • Retorna uma carga por id
  • Inventory
    • Movimentar estoque
  • Tags
    • Listar Tags
  1. Sales

Cadastrar um novo pedido

POST
/sales
Pedidos no Sensio podem ser vendas, orçamentos ou compras. Com esse endpoint você pode cadastrar um novo pedido.
É obrigatório o tipo e itens (saleLines). O código é gerado pelo próprio Sensio.
Para integrações, você pode utilizar os campos orig e origId para referenciar, exemplo orig "Ecommerce X", origId "1234".
Você pode passar o id do cliente pelo atributo customerId, ou o nome pelo atributo customer.

Requisição

Parâmetros Bodyapplication/json

Exemplo
{
    "child": "string",
    "total": 0,
    "dateSold": "2019-08-24",
    "fixedPaymentsDate": true,
    "type": "Venda",
    "status": "Em aberto",
    "paymentConditionType": "2x, 30 60 90",
    "paymentMethod": "Dinheiro",
    "priceList": "string",
    "payments": [
        {
            "nDup": 0,
            "dVenc": "2019-08-24",
            "vDup": 0,
            "tPag": "string",
            "acquirerFee": 0
        }
    ],
    "customer": "string",
    "customerId": "string",
    "otherExpenses": 0,
    "discount": 0,
    "discountType": "R$",
    "discountPercentage": 0,
    "transportFee": 0,
    "details": "string",
    "oc": "string",
    "sellersInfo": [
        {
            "seller": "string",
            "comissionType": "%",
            "comissionValue": 0,
            "comission": 0
        }
    ],
    "netTotal": 0,
    "negotiationStatus": "Em orçamento",
    "dueDate": "2019-08-24",
    "foreseenDelivery": "2019-08-24",
    "quoteDate": "2019-08-24",
    "orig": "string",
    "origId": "string",
    "tags": [
        {
            "tagId": "string"
        }
    ],
    "origStatus": "string",
    "origPaymentMethod": "string",
    "bonificacao": false,
    "carrier": "string",
    "modFrete": "0 - Por conta do emitente",
    "foreseenShipment": "2019-08-24",
    "shipmentDetails": "string",
    "shipmentAddress": "Endereço da Pessoa",
    "shipment": "string",
    "shipped": true,
    "shipmentCode": "string",
    "shipmentDate": "2019-08-24",
    "approved": true,
    "description": "string",
    "saleLines": [
        {
            "productId": "string",
            "variationId": "string",
            "qty": 0,
            "price": 0,
            "details": "string",
            "detailsNF": true
        }
    ],
    "contactId": "string",
    "acquirer": {
        "isWithAcquirerFee": true,
        "acquirerId": "string",
        "feeType": "string"
    }
}

Códigos de solicitação

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/sales' \
--header 'Content-Type: application/json' \
--data-raw '{
    "child": "string",
    "total": 0,
    "dateSold": "2019-08-24",
    "fixedPaymentsDate": true,
    "type": "Venda",
    "status": "Em aberto",
    "paymentConditionType": "2x, 30 60 90",
    "paymentMethod": "Dinheiro",
    "priceList": "string",
    "payments": [
        {
            "nDup": 0,
            "dVenc": "2019-08-24",
            "vDup": 0,
            "tPag": "string",
            "acquirerFee": 0
        }
    ],
    "customer": "string",
    "customerId": "string",
    "otherExpenses": 0,
    "discount": 0,
    "discountType": "R$",
    "discountPercentage": 0,
    "transportFee": 0,
    "details": "string",
    "oc": "string",
    "sellersInfo": [
        {
            "seller": "string",
            "comissionType": "%",
            "comissionValue": 0,
            "comission": 0
        }
    ],
    "netTotal": 0,
    "negotiationStatus": "Em orçamento",
    "dueDate": "2019-08-24",
    "foreseenDelivery": "2019-08-24",
    "quoteDate": "2019-08-24",
    "orig": "string",
    "origId": "string",
    "tags": [
        {
            "tagId": "string"
        }
    ],
    "origStatus": "string",
    "origPaymentMethod": "string",
    "bonificacao": false,
    "carrier": "string",
    "modFrete": "0 - Por conta do emitente",
    "foreseenShipment": "2019-08-24",
    "shipmentDetails": "string",
    "shipmentAddress": "Endereço da Pessoa",
    "shipment": "string",
    "shipped": true,
    "shipmentCode": "string",
    "shipmentDate": "2019-08-24",
    "approved": true,
    "description": "string",
    "saleLines": [
        {
            "productId": "string",
            "variationId": "string",
            "qty": 0,
            "price": 0,
            "details": "string",
            "detailsNF": true
        }
    ],
    "contactId": "string",
    "acquirer": {
        "isWithAcquirerFee": true,
        "acquirerId": "string",
        "feeType": "string"
    }
}'

Respostas

🟢201Created
application/json
Sucesso
Body

Exemplo
{
    "success": true,
    "message": "Pedido registrado com sucesso",
    "response": "Id do pedido registrado"
}
Modificado em 2025-06-20 13:07:18
Página anterior
Retorna um pedido específico, buscando pelo código
Próxima página
Cancelar um pedido
Built with