POST pedidos compra - Varejonline/api GitHub Wiki

URL

POST https://integrador.varejonline.com.br/apps/api/pedidos-compra

Parâmetros

Envie um JSON no corpo da requisição, contendo:

  • dataCompra: data do pedido de compra (string) (obrigatório)
  • dataLimiteEntrega: data de limite de entrega do pedido de compra (string) (obrigatório)
  • entidade: entidade utlizada (obrigatório informar um dos critérios para a busca da entidade. Utiliza-se o primeiro critério da ordem)
  • fornecedor: fornecedor do pedido (obrigatório informar um dos critérios para a busca do fornecedor. Utiliza-se o primeiro critério da ordem)
    • id: id do terceiro fornecedor do pedido de compra (long)
    • documento: documento do terceiro fornecedor do pedido de compra (string)
  • referenciaPedidoFornecedor: número da referência do pedido no fornecedor (string) (opcional)
  • valorSeguro: valor de seguro do pedido de compra (decimal) (obrigatório)
  • valorFrete: valor de frete do pedido de compra (decimal) (obrigatório)
  • valorOutros: valor de outros do pedido de compra (decimal) (obrigatório)
  • parcelas: lista de parcelas do pedido de compra (obrigatório)
    • dataVencimento: data de vencimento da parcela (string) (obrigatório)
    • valor: valor da parcela (decimal) (obrigatório)
  • observacao: observações do pedido de compra (string) (opcional)
  • tipoPlanoPagamento: id do plano de pagamento (long) (opcional)
  • produtos: lista de produtos do pedido de compra (obrigatório)
    • produto: (obrigatório informar um dos critérios para a busca do produto. Utiliza-se o primeiro critério da ordem)
    • quantidade: quantidade de produtos (decimal) (obrigatório)
    • valorDesconto: valor de desconto no produto (decimal) (opcional)
    • valorUnitario: valor unitário do produto (decimal) (obrigatório)
    • idOperacao: valor que indica o id da operação de compra do produto. (obrigatório)
  • dataPrevisaoEntrega: data de previsão de entrega do pedido de compra (string) (opcional)

Observações

Formatos aceitos na string de data: dd-mm-aaaa ou dd-mm-aaaa hh:mm:ss

Retorno

Sucesso:

  • HTTP STATUS 201 – CREATED
  • Body: id do pedido de compra gerado

Requisição inválida:

  • HTTP STATUS 400 – BAD REQUEST
  • Body: mensagem de erro

Exemplo

POST https://integrador.varejonline.com.br/apps/api/pedidos-compra

'Content-Type'='application/json'

{
   "dataCompra":"07-05-2021",
   "dataLimiteEntrega":"07-07-2021",
   "entidade": {
       "id": 1,
       "documento": "00.000.000/0000-00"
   },
   "fornecedor": {
       "id": 1,
       "documento": "00000000000000"
   },
   "referenciaPedidoFornecedor":"REF. PEDIDO 1",
   "valorSeguro":0,
   "valorFrete":0,
   "valorOutros":0,
   "parcelas":[
      {
         "dataVencimento":"07-06-2021",
         "valor":25
      },
      {
         "dataVencimento":"07-07-2021",
         "valor":25
      }
   ],
   "observacao":"Detalhe adicional",
   "tipoPlanoPagamento": 2,
   "produtos":[
      {
         "produto": {
             "codigoSistema" : "0082.0005" 
         },
         "quantidade":10,
         "valorDesconto":0,
         "valorUnitario":5,
         "idOperacao":20
      }
   ],
   "dataPrevisaoEntrega":"07-06-2021"
}