Importa um XML de nota fiscal já emitida para o pedido
POST/orders/:idorder/invoice/upload
Importa um XML de NF-e/NFC-e autorizado para vincular ao pedido (cenário em que a nota foi emitida fora do idworks ou em sistema integrado). Validações:
- XML precisa estar assinado (com
protNFe). - CNPJ do emitente precisa bater com a empresa do pedido ou com uma empresa faturadora relacionada.
- Quando a parametrização
ValidadeOrderInvoiceestá ligada, valida o XML contra o schema da SEFAZ usando o certificado digital da faturadora. - Bloqueia XML já importado, pedido cancelado/excluído, pedido que já tenha nota vinculada (desvincular antes) e (a menos que
IgnoreTotalInvoiceValueImportOrderesteja ligado) valor total da nota divergente do pedido. - Valida CPF/CNPJ do cliente.
Em sucesso, atualiza o cabeçalho do pedido com os dados extraídos do XML, cria o registro da nota com a chave/protocolo/status, importa os impostos calculados nos itens (quando o item importado bate IDSku/Quantity/PriceSelling com a movimentação), salva o XML, importa as chaves referenciadas e registra um evento. Sistema em PHP — contrato confirmado no código.
Request
Responses
- 200
- 400
- 500
XML importado e nota vinculada ao pedido.
Erros possíveis (BusinessException no PHP — convertidos para resposta de erro pelo sistema): É necessário selecionar a conta, XML não é válido, XML não esta assinado, O arquivo não é um XML de Nota Fiscal válido, NF fiscal não pode ser importada em pedido com status cancelado/deletado, Empresa faturadora CNPJ: <cnpj> não localizada, Empresa faturadora não encontrada, Certificado digital não encontrado, XML já importado, Pedido já tem nota fiscal. Desvincular antes de importar uma nova, Número de série e NF informados já estão cadastrados para o IDOrder <id> e faturador <faturador>, Valor da NF diverge do valor do pedido. Valor total NF: <valor>, CPF/CNPJ do cliente é diferente do pedido, e mensagens da SEFAZ (quando a validação contra schema falha).
Erro interno. Resposta com prefixo Error:.