Sign in

v1

latestOpenAPI 3.0.3Licença Sankhya2026-07-24161242654.8 KB
Vendas Pedidos

Atualizar Pedido de Venda

A atualização de um Pedido de Venda já confirmado só é permitida se a TOP do pedido estiver configurada com a opção 'Permitir Alteração após Confirmar' ativada. Alem disto, na alteração de pedido, sempre enviar o itens e os financeiros.

  • Versão mínima requirida do Sankhya Om para utilizar essa API: 4.34
put/v1/vendas/pedidos/{codigoPedido}

Path parameters

codigoPedidointeger required
Example:4599

Informe neste atributo o "código do pedido" desejado

Request body

datastring required

Data da emissão do documento

horastring required

Data da emissão do documento

codigoVendedorinteger

Para registrar com precisão as vendas, insira o código do vendedor responsável pela negociação. Esse código é facilmente acessível através da nossa API, na entidade "Vendedor" (CODVEND). Obtenha essa informação e mantenha seus registros sempre atualizados. Para saber mais, clique aqui

codigoClienteinteger

Insira o código do cliente.Esse código é facilmente retornado pelo serviço: GET /v1/parceiros/clientes

observacaostring
valorFretenumber
valorSeguronumber
valorOutrosnumber
valorIcmsnumber
valorCofinsnumber
valorFcpnumber

Valor referente a ICMS Fundo de Combate a Pobreza

valorJuronumber

Valor referente a juros acrescidos no documento

valorTotalnumber required

Valor total final do documento

Example request

{
  "data": "30/05/2024",
  "hora": "07:34",
  "codigoVendedor": 11,
  "codigoCliente": 8115,
  "observacao": "Observações específicas da venda aqui",
  "valorFrete": 50,
  "valorSeguro": 10,
  "valorTotal": 1060,
  "itens": [
    {
      "sequencia": 1,
      "sequenciaItemOrigem": 2,
      "codigoProduto": 9145,
      "cfop": "5405",
      "unidade": "UN",
      "quantidade": 10,
      "controle": "Verde",
      "valorUnitario": 100,
      "impostos": [
        {
          "tipo": "ibs",
          "cst": "00",
          "tributacaoMunicipio": "140801",
          "classificacaoTributaria": 200,
          "aliquota": 26.5,
          "aliquotaEfetivaRegular": 26.5,
          "aliquotaEfetivaBaseCalculo": 26.5,
          "percentualReducaoAliquotaGovernamental": 60,
          "percentualDiferimento": 10,
          "valorBase": 1000,
          "valorBaseReduzida": 400,
          "valorImposto": 106,
          "valorRegular": 106,
          "valorDiferimento": 10.6
        }
      ]
    }
  ],
  "financeiros": [
    {
      "tipoPagamento": 19,
      "cheque": {
        "codigoBarras": "\"341067330330018805201725766099\"",
        "banco": "341",
        "agencia": "0673",
        "conta": "576609",
        "nome": "José da Silva Souza",
        "cnpjCpf": "14532515955"
      },
      "cartao": {
        "bandeira": "02"
      },
      "dataVencimento": "30/05/2024",
      "dataBaixa": "30/05/2024",
      "valorParcela": 1060,
      "idTransacao": "dadotiuiwnlkeuhcnhlahdiwlaoaokd48ge55x"
    }
  ]
}

Response

Operação bem sucedida

codigointeger
tipostring
mensagemstring

Example response

{
  "mensagem": "Pedido Incluído/Atualizado/Cancelado com sucesso.",
  "retorno": {
    "codigoPedido": 98115
  }
}