[Fulfillment] Fiscal Documents: Como consultar suas Notas Fiscais de Fulfillment

Este artigo explica como consultar notas fiscais de fulfillment no ANYMARKET por meio do recurso Fiscal Documents, centralizador de documentos fiscais enviados pelos marketplaces.

O Fiscal Documents permite visualizar, consultar e baixar notas fiscais de fulfillment de forma unificada, rastreável e confiável. O recurso é indicado para sellers que vendem no modelo fulfillment e precisam de estabilidade e visibilidade no fluxo fiscal.

Neste artigo:

• Pré-requisitos
• Como funciona o Fiscal Documents
• Como consultar documentos fiscais
• Boas práticas
• Dúvidas comuns

Pré-requisitos

Para utilizar o Fiscal Documents, é necessário solicitar ao suporte a liberação do recurso na conta.

A solicitação pode ser feita via chat ou ticket pelo portal de atendimento.

A consulta das notas fiscais de fulfillment no ANYMARKET é realizada exclusivamente via API, por meio do endpoint:

fiscalDocument

Documentação da API Fiscal Documents:

Acesse a documentação da API Fiscal Documents

Como funciona o Fiscal Documents

O Fiscal Documents centraliza o recebimento, armazenamento e consulta de documentos fiscais enviados pelos marketplaces no modelo fulfillment.

O recurso foi desenvolvido para simplificar e fortalecer a operação fiscal, oferecendo:

• Acesso centralizado e rápido a todas as notas fiscais;
• Histórico completo e confiável de documentos, sempre atualizado;
• Segurança no recebimento das notas com contingência de reprocessamento, mesmo em caso de falhas de envio;
• Independência do pedido importado, permitindo visualizar a nota assim que ela existir;
• Eliminação de ferramentas externas, com a consulta realizada diretamente pelo ANYMARKET via API.

Quais tipos de documentos podem ser consultados?

É possível consultar:

• NF-e de venda;
• NF-e de remessa ou inbound;
• CT-e, conhecimento de transporte;
• Eventos de autorização e cancelamento;
• Documentos referenciados, como notas relacionadas a um CT-e;
• NF-e inutilizadas.

Recursos disponíveis na API

A API Fiscal Documents foi desenvolvida para oferecer uma forma eficiente e padronizada de obter documentos fiscais no modelo fulfillment.

Ela permite:

• Consulta com filtros avançados: permite filtrar documentos por data de emissão, marketplace, tipo de documento, pedido, status, chave da nota, entre outros;
• Histórico completo de eventos: cada documento retorna seus eventos fiscais, como autorizado, cancelado, inutilização e reenvios;
• Relacionamentos entre documentos: permite identificar vínculos, como CT-e e notas referenciadas;
• Acesso ao XML completo: o XML do evento pode ser baixado pela própria API;
• Suporte a paginação: ideal para consultas em alto volume ou automações fiscais contínuas.

Marketplaces compatíveis

O fluxo Fiscal Documents já está disponível para fulfillment dos seguintes marketplaces:

• Mercado Livre;
• Magalu;
• Shopee;
• Amazon;
• Netshoes;
• Dafiti.

Como consultar documentos fiscais

1. Solicite ao suporte a liberação do recurso Fiscal Documents na conta;
2. Acesse a documentação da API Fiscal Documents;
3. Utilize o endpoint fiscalDocument para consultar os documentos fiscais;
4. Aplique os filtros necessários, como marketplace, pedido, status, data de emissão, chave da nota ou tipo de documento;
5. Consulte os eventos fiscais relacionados ao documento, como autorização, cancelamento, inutilização ou reenvio;
6. Quando necessário, baixe o XML completo pela própria API;
7. Utilize paginação em consultas de alto volume ou automações fiscais recorrentes.

Boas práticas

• Solicite a liberação do recurso antes de iniciar qualquer integração ou consulta.
• Utilize filtros para evitar consultas amplas demais em operações com grande volume de documentos.
• Consulte os eventos fiscais para entender o histórico completo do documento.
• Use os relacionamentos entre documentos para identificar vínculos entre CT-e, notas de remessa e notas de venda.
• Baixe o XML completo pela API quando precisar validar detalhes fiscais.
• Utilize paginação em rotinas automatizadas ou consultas com muitos registros.
• Considere que as notas permanecem disponíveis mesmo quando o pedido relacionado passa por cancelamento.

Dúvidas comuns

O que é o Fiscal Documents?
O Fiscal Documents é o centralizador de documentos fiscais do ANYMARKET. Ele permite consultar, visualizar e baixar notas fiscais de fulfillment enviadas pelos marketplaces.

Como acesso o Fiscal Documents?
A consulta é realizada exclusivamente via API, utilizando o endpoint fiscalDocument. Antes disso, é necessário solicitar ao suporte a liberação do recurso na conta.

Quais documentos posso consultar?
É possível consultar NF-e de venda, NF-e de remessa ou inbound, CT-e, eventos de autorização e cancelamento, documentos referenciados e NF-e inutilizadas.

O que acontece se o marketplace falhar no envio da nota?
O Fiscal Documents possui contingência de reprocessamento, reduzindo o risco de perda de notas.

Posso ver uma nota autorizada de um pedido que foi cancelado?
Sim. O sistema mantém o documento disponível mesmo após o cancelamento do pedido.

Notas de venda e de remessa ficam separadas?
Sim. Elas continuam separadas e cada uma mantém seu próprio registro. Porém, as notas são referenciadas entre si, permitindo entender o relacionamento entre remessa e venda sem perder organização ou histórico.

Consigo ver os dados da nota fiscal diretamente na venda?
Sim. Os dados principais da nota fiscal de venda, como chave de acesso, número e série, ficam salvos e disponíveis diretamente no contexto da venda. Isso facilita consultas rápidas, conferências e integrações, sem necessidade de buscar essas informações em outros sistemas ou no XML.

Quais marketplaces são compatíveis?
O fluxo Fiscal Documents está disponível para fulfillment dos marketplaces Mercado Livre, Magalu, Shopee, Amazon, Netshoes e Dafiti.

É possível baixar o XML da nota?
Sim. O XML completo do evento pode ser baixado pela própria API.