POST Pedidos Compra - Varejonline/api GitHub Wiki
POST https://integrador.varejonline.com.br/apps/api/pedidos-compra
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)
- 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)
- usuarioComprador: id do usuário a ser considerado como comprador responsável pelo pedido (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)
- valorAcrescimo: valor de acréscimo 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)
- idPedidoVendaEntregaFutura: id do pedido de venda de entrega futura (encomenda) ao qual este item será vinculado (long) (opcional)
- dataPrevisaoEntrega: data de previsão de entrega do pedido de compra (string) (opcional)
- geradoEntregaFutura: indica que o pedido de compra é gerado a partir de venda(s) de entrega futura (boolean) (opcional, padrão false)
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.
Informar idPedidoVendaEntregaFutura em qualquer item marca o pedido como geradoEntregaFutura = true automaticamente, não é necessário enviar o campo na raiz nesses casos.
O fluxo de aprovação de pedido de compra só é iniciado quando o comprador responsável é identificado. Isso ocorre quando o usuário autenticado na API está cadastrado como comprador no ERP, ou quando o campo usuarioComprador é informado no corpo da requisição.
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
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"
}