Agora no Bluesoft ERP, é possível importar e vincular XML de vendas do E-commerce via API
Para garantir uma integração mais fluida com plataformas de e-commerce onde a venda é faturada externamente, disponibilizamos um novo endpoint na API do ERP Nexus.
Este recurso permite enviar o XML da Nota Fiscal emitida externamente para o ERP, realizando o vínculo automático com o Pedido de Venda correspondente e atualizando seu status para “Faturado”, mitigando erros manuais e garantindo a integridade dos dados fiscais e de estoque,.
Como funciona?
A integração ocorre de forma assíncrona. Ao enviar o XML e a chave de identificação do pedido, o sistema valida as informações e processa o vínculo. Caso aprovado, os impostos são gravados exatamente conforme o XML e o pedido é atualizado.
Dados Técnicos
• Endpoint: /api/vendas/pedidovenda/e-commerce/vincular-xml
• Método: POST
• Permissão Necessária: 4426 - Vincular Nota Fiscal ao Pedido Ecommerce.
Estrutura do Payload (Corpo da Requisição)
Para realizar o vínculo, é necessário informar o XML (em Base64) e ao menos um identificador do pedido (pedidoVendaKey ou ecommerceKey),.
| Campo | Tipo | Obrigatoriedade | Descrição |
|---|---|---|---|
xmlBase64 | String | Sim | Conteúdo do XML da NF-e codificado em Base64. |
pedidoVendaKey | Integer | Opicional | Chave primária do pedido de venda no ERP. |
ecommerceKey | String | Condicional* | Código do pedido na plataforma de e-commerce externa. |
numeroPedidoEcommerce | String | Condicional* | Número visual do pedido no e-commerce (usado em conjunto com ecommerceKey). |
Exemplo de Requisição (JSON)
{
"pedidoEcommerceImportarXml": {
"pedidoVendaKey": 433881,
"ecommerceKey": null,
"numeroPedidoEcommerce": null,
"xmlBase64": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4..."
}
}
Retorno e Monitoramento
Ao enviar a requisição com sucesso, a API retornará o status 201 Created e um requestId. Utilize este ID no endpoint de monitoramento para verificar se o processamento foi concluído (“DONE”) ou se houve erros (“ERROR”),.
Endpoint de Monitoramento: GET /api/monitoramento/async/{requestId}
Regras de Negócio e Validações
O sistema aplicará as seguintes validações rígidas para garantir a consistência dos dados:
1. Validação de Loja (CNPJ): O sistema verifica se o CNPJ do emitente contido no XML corresponde à Loja do pedido de venda no ERP. Se houver divergência, o vínculo é rejeitado.
2. Natureza da Operação (CFOP): O sistema valida se o CFOP do XML é compatível com operações de venda e-commerce.
3. Gravação de Impostos: Serão gravados exatamente os valores tributários informados no XML importado.
4. Quitação de Duplicatas: Se o parâmetro de quitação automática estiver ativo nas configurações do e-commerce, o sistema processará a baixa das parcelas conforme os dados do XML.
Para conhecer mais sobre como é a utilização dessa ferramenta, clique aqui.
Para saber mais sobre a utilização das APIs do ERP, clique aqui.