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 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
      GET
    • Retorna uma NFe específica
      GET
    • Retorna XML da NFe
      GET
    • Retorna DANFE da NFe
      GET
  • 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
    • Retorna quitações paginadas
    • 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
    • Retorna categorias financeiras
    • Retorna categoria financeira
    • Retorna centros de custos
  • 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
  • PriceLists
    • Listar tabelas de preços
    • Retorna tabela de preço por id
  • Esquemas
    • Schemas
      • nfse
      • batch
      • accounts
      • cte
      • stage
      • cargo
      • tag
      • typeOfCharacteristics
      • symbolCharacteristics
      • typePlanReaction
      • paymentCondition
      • activityType
      • frequency
      • typeOfMethodControl
      • evaluationType
      • processType
      • controlPlan
      • supplierItem
      • dimensionControlPlan
      • instrumentDimension
      • category
      • costCenter
      • priceList
      • item
      • composition
      • view_composition
      • view_compositionChild
      • compositionChild
      • saleListObject
      • webHookURL
      • createNFeBody
      • salePostObject
      • sale
      • person
      • Person
      • transactionPostObject
      • transaction
      • po
      • service
      • dimensions
      • itemType
      • veic
      • variation
      • image
      • nfe
      • warehouseListObj
      • nfeListObj
      • userInfo
      • inline_response_500
      • register_item_response_200
      • request_register_item
      • request_edit_item
      • response_error
      • inline_response_200
      • inline_response_403
      • inline_response_200_1
      • inline_response_200_2
      • inline_response_200_3
      • inline_response_201
      • inline_response_200_4
      • inline_response_404
      • inline_response_200_5
      • inline_response_401
      • inline_response_201_1
      • inline_response_200_6
      • inline_response_200_7
      • inline_response_200_8
      • inline_response_200_9
      • inline_response_401_1
      • item_tags
      • get_compositions
      • item_warehouses
      • item_config
      • item_ecommerces
      • item_ativo
      • item_customFields
      • item_updates
      • salePostObject_payments
      • salePostObject_sellersInfo
      • salePostObject_tags
      • salePostObject_saleLines
      • salePostObject_acquirer
      • sale_payments
      • sale_events
      • sale_saleLines
      • sale_attachments
      • sale_updates
      • Person_address
      • Person_integrations
      • transactionPostObject_payments
      • transaction_sharingCost_fields
      • transaction_sharingCost
      • transaction_attachments
      • transaction_emailsSends
      • transaction_updates
      • po_tasks
      • po_sales
      • po_items
      • po_itemsDone
      • po_events
      • po_customFields
      • po_updates
      • service_updates
      • nfe_dest_enderDest
      • nfe_dest
      • nfe_prod
      • nfe_impostos_ICMS
      • nfe_impostos_IPI
      • nfe_impostos_PIS
      • nfe_impostos_COFINS
      • nfe_impostos
      • nfe_items
      • nfe_total
      • userInfo_userInfo_companies
      • userInfo_userInfo
    • Response
      • ErrorServer
      • Forbidden
  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