POST pedidos compra

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)
  • id: id da entidade (long)
  • documento: documento da entidade (string)
• 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)
    • id: id do produto
    • codigoSistema: código de sistema do produto
  • 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".

É possível ajustar um parâmetro no ERP para rejeitar pedidos de compras duplicados, de acordo com a referenciaPedidoFornecedor e outros critérios. Detalhes em: Configuração de pedido de compra.

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"
}