Cria recebimento a partir de NF do Feed, pedido próprio ou XML cru
POST/purchase/xml
Cria o recebimento a partir de uma NF-e, resolvendo o XML de três fontes: IDNfEvents (nota do Feed NF), IDOrder (nota de um pedido de venda próprio, para devolução de cliente) ou o XML cru no corpo da requisição. O fornecedor é resolvido pelo CNPJ do emitente e cadastrado automaticamente quando ainda não existe, usando a categoria de fornecedor de produto ativa da empresa. O armazém informado em IDStockKeepingUnitWarehouse — ou, quando ele é omitido, o armazém de origem da mercadoria do pedido (fluxo IDOrder) ou o armazém padrão ativo da empresa — determina também o centro de distribuição em que o recebimento é criado. O recebimento é criado em status 0 Aberto e em seguida o XML é processado por inteiro (impostos, SKUs, lotes e duplicatas); se esse processamento falhar, o recebimento recém-criado é removido e o erro é devolvido. O critério de amarração de SKU de ImportType só é considerado no fluxo IDNfEvents: no fluxo IDOrder o sistema procura sempre pelo código do SKU na empresa e, no envio de XML cru, tenta em ordem o código do SKU na empresa, o código do produto no fornecedor, o código do anúncio no canal e o código de barras. A recusa de nota de saída vale apenas no fluxo IDOrder, em que a nota foi emitida pela própria empresa; no Feed NF a nota é de saída do emitente por natureza e é aceita normalmente. Com OnlyPayment=1 o recebimento não é criado — apenas as contas a pagar correspondentes às duplicatas do XML.
Request
Responses
- 200
- 400
Recebimento criado. O corpo tem duas formas:
- Fluxo normal: um objeto
{ "IDPurchase": <inteiro>, "SupplierNameCorporateName": <texto> }. - Com
OnlyPayment=1: um array de objetos{ "IDAccountPayableReceivable": <inteiro>, "SupplierNameCorporateName": <texto> }, um por duplicata do XML.
SupplierNameCorporateName é a razão social lida da própria nota (emitente do XML ou empresa do pedido) e pode ser diferente do nome já cadastrado do fornecedor.
Mensagens (prefixo [BadRequest]):
Precisa ser enviado o IDOrder ou IDNfEvents ou XMLNota fiscal não encontradaNota fiscal de saída não permite criar recebimento. Gerar pedido de devolução para criar recebimentoArmazém não encontrado— armazém informado inexistente, inativo ou de outra empresa.Não foi informado armazém— nenhum armazém informado e a empresa não tem armazém padrão ativo.Categoria de fornecedor de produto não existe— fornecedor novo e a empresa não tem categoria de fornecedor de produto ativa.
No fluxo OnlyPayment=1:
Nota fiscal não possui dados de cobrançaNota fiscal não possui duplicatas de cobrançaTipo de documento não encontradoPlano de contas padrão para compras não cadastradoJá existe contas a pagar cadastrada
Erros propagados do processamento do XML chegam com a mensagem original; o recebimento recém-criado é removido antes da resposta.