 | Documentação Técnica |
Autorização Automática de NF-e — Fullfilment
Reprocessamento de notas fiscais a partir do XML já autorizado
| Rotina ADTRANML | Módulo Faturamento / SPED NF-e | Plataforma Protheus 12.1.2410 · TSS | Ponto de entrada Fonte nfesefaz |
O que a rotina faz
A ADTRANML autoriza no Protheus, de forma automática, as notas de remessa de fullfilment do Mercado Livre que já foram emitidas e autorizadas pela SEFAZ — reaproveitando o XML original em vez de gerar uma nova nota.
O objetivo é destravar notas que, ao serem regeradas pelo Protheus, falhavam na autorização por divergências de cadastro. Como o XML do Mercado Livre já passou por todas as validações do fisco, a rotina o utiliza como fonte da verdade, garantindo que o documento fique autorizado no monitor e com as tabelas fiscais coerentes para o SPED e a DANFE.
O problema que resolvemos
No modelo de fullfilment, o Mercado Livre emite e autoriza a NF-e de remessa em nome da empresa. O XML autorizado é importado no Protheus, mas ao tentar transmitir a nota pelo fluxo padrão, o ERP reconstrói o documento e algumas notas eram rejeitadas.
|
🔴 Falha de cadastro Dados regerados pelo Protheus (ex.: telefone incompleto) quebravam o schema da NF-e. |
🔴 Nota travada Documentos ficavam sem autorização no monitor — impedindo DANFE e SPED. |
|
🟡 XML já autorizado Ao mesmo tempo, existia o XML válido do ML — com todos os dados aceitos pela SEFAZ. |
🟢 Solução Usar o XML autorizado como base e recuperar a autorização existente na SEFAZ. |
Como funciona, passo a passo
1 | Seleção das notas ZTQ A rotina consulta a tabela de integração (ZTQ) e seleciona as notas de fullfilment ML (série 800) que possuem o XML autorizado importado e ainda não estão autorizadas. Pode rodar em lote (Schedule) ou por nota. |
2 | Transmissão pelo fluxo oficial SpedNFeTrf A nota é transmitida pelo mesmo motor da "Transmissão" do monitor — garantindo que o processo passe pela geração de XML do cliente, onde ocorre a conversão. |
3 | Conversão do XML ADXMLENV No momento da geração, a rotina substitui o XML que o Protheus montaria pelo XML autorizado do ML — convertido do layout oficial NF-e 4.00 para o layout interno do TSS (T01.00). Assim o TSS assina e transmite com os dados já validados pela SEFAZ. |
4 | Assinatura e envio à SEFAZ O TSS assina e transmite. Como a nota já havia sido autorizada, a SEFAZ responde Rejeição 228 (Data de Emissão atrasada) — porém o documento fica registrado no TSS com a chave correta. Comportamento esperado |
5 | Consulta do protocolo ConsultaProtocoloNfe A rotina consulta a situação do documento na SEFAZ — como o botão "Consulta NFe" do monitor. Como a chave já está autorizada, a SEFAZ retorna cStat 100 — Autorizado o uso e o protocolo original, gravado definitivamente pelo TSS. |
6 | Nota autorizada Concluído O documento passa a constar Autorizado no monitor, com protocolo e XML corretos disponíveis para DANFE e para a apuração do SPED Fiscal. |
As duas peças da solução
|
Orquestrador ·
ADTRANML
|
Conversor ·
ADXMLENV
|
Condições para operação
| Item | Configuração | Observação |
|---|---|---|
| Ponto de entrada | Fonte nfesefaz | Inserir a chamada do ADXMLENV no fonte padrão. |
| Ambiente SEFAZ | Produção | A chave só está autorizada em produção. |
| XML autorizado | ZTQ · ZTQ_FILEML | XML da NF-e importado previamente. |
| Entidade do TSS | VT_IDENTVT | Identificador da empresa no TSS. |
| URL do TSS | MV_SPEDURL | Endereço do serviço TSS. |
| Execução | Schedule ou manual | Lote periódico ou por nota individual. |
| ✓ | Notas autorizadas sem intervenção manual Documentos de fullfilment que falhavam passam a ser autorizados automaticamente, aproveitando o XML oficial do Mercado Livre — com fidelidade fiscal e prontos para SPED e DANFE. |
| ATOSDATA Documentação técnica · Fullfilment | Preparado por Atos Data |
Comentários
0 comentário
Por favor, entre para comentar.