Conferir a coluna XML marketplace
Ative a coluna e entenda os estados Enviado, Falhou, Não se aplica e Chave capturada antes de tentar outra ação.
Objetivo: usar a coluna XML marketplace como conferência diária do que foi enviado, do que exige correção e do que não deve receber novo XML. Resultado esperado: o operador toma a próxima ação pelo estado e pelo motivo exibidos, sem reenviar documentos às cegas.
Antes de começar
Perfil ou permissão: Usuário com acesso à lista de Pedidos Externos; o envio em massa e suas configurações exigem administrador.
Caminho: Entradas > Pedidos Externos > Colunas > XML marketplace
- Pedidos sincronizados e, quando aplicável, convertidos em venda.
- Integração do canal identificada na linha.
- NF-e da venda conferida antes de tratar qualquer falha.
1. Mostre a coluna na lista
- Abra Entradas > Pedidos Externos.
- No canto da lista, abra Colunas.
- Na área de colunas extras, marque XML marketplace.
- Feche o menu e mantenha a coluna visível ao filtrar, selecionar ou revisar pedidos.
No modelo de lista que apresenta a tabela, o cabeçalho pode aparecer abreviado como XML mkt.. Em outras apresentações da central, a mesma informação pode surgir como indicador no bloco fiscal do pedido; o significado dos estados é o mesmo.
2. Leia cada estado antes de agir
| Estado na coluna | O que significa | O que fazer |
|---|---|---|
| Enviado | O XML já foi comunicado ao canal e o sistema registrou a tentativa como concluída. | Não inclua novamente em lote. Consulte o canal somente se houver evidência concreta de divergência. |
| Pendente | Existe venda com NF-e autorizada, mas o XML ainda não foi enviado para o canal. | Use o envio automático, em massa ou individual conforme a operação e a compatibilidade do canal. |
| Falhou | A última tentativa não foi concluída. A linha pode informar a mensagem retornada pela integração. | Leia o motivo, confira NF-e e conexão e tente novamente somente depois da correção. |
| Não se aplica | Não há upload de XML para aquele cenário: por exemplo, integração sem esse recurso, NF-e emitida no canal ou logística FULL tratada pelo marketplace. | Não force um novo XML. Confirme com o processo fiscal da empresa se há alguma exceção real. |
| Chave capturada | Em cenários de Temu ou Kwai, a chave da NF-e foi registrada para o fluxo do canal. | Não interprete esse estado como upload de XML por API; siga a exigência do Seller Center quando aplicável. |
| — | Em geral ainda falta uma condição: pedido sem venda, NF-e não aprovada, referência externa ausente ou venda vinculada não encontrada. | Leia o motivo da linha e resolva essa etapa antes de procurar o botão de envio. |
3. Use a coluna junto com as demais informações
- Confira Origem para saber qual canal receberia o documento.
- Confira Conversão e Venda para garantir que o pedido aponta para o registro correto do C Controle.
- Confira NF-e. Sem aprovação fiscal, uma linha com traço não é falha de XML.
- Abra a venda quando houver Falhou; a correção pode estar na nota, na autorização do canal ou na relação do pedido, e não no botão de reenvio.
Como tratar Falhou com segurança
- Anote ou copie a mensagem exibida e identifique o pedido, a venda e o canal.
- Confirme se a NF-e ainda está autorizada e pertence àquela venda.
- Verifique se a integração está conectada. Se houver erro de autorização, corrija a conexão antes do reenvio.
- Depois da correção, envie somente aquele pedido ou um grupo pequeno. Atualize a lista e confirme se mudou para Enviado.
Como confirmar
O fluxo está correto quando a coluna deixa claro por que cada pedido está pendente ou finalizado. Para organizar vários pendentes, consulte Enviar XML ao marketplace em massa.
Próximo passo
Se o objetivo for deixar as próximas NF-e compatíveis seguirem sem clique adicional, leia Envio automático de XML ao marketplace.
Revisado em: 31/07/2026.
Esse artigo foi útil?
Obrigado pelo retorno!
Sem problemas — fale direto com o nosso suporte que a gente resolve com você:
(32) 3721-6702