wBuy e NF-e: XML, DANFE e atualização do status fiscal

Objetivo: explicar com precisão o retorno fiscal do CControle para a wBuy. Resultado esperado: a equipe não tenta usar uma configuração técnica antes da confirmação necessária e entende que ela nunca substitui a emissão fiscal normal.

O que essa rotina faz — e o que não faz

Quando habilitada, ela devolve ao pedido wBuy os dados de uma NF-e autorizada: número, série, CFOP, chave de acesso, data de emissão e os links públicos de XML e DANFE.

Ela não emite a nota, não transmite para a SEFAZ, não assina XML e não corrige tributação. Tudo isso continua no fluxo fiscal do CControle antes de qualquer retorno para a loja virtual.

Por que essa opção começa desligada

A documentação da wBuy tem uma divergência sobre o status após a nota: a tabela de status informa 14 como “Nota fiscal emitida”, enquanto um exemplo do endpoint cita 17. Como o código errado pode mover o pedido para uma etapa operacional indevida, o CControle mantém o envio desligado até que a wBuy confirme formalmente qual número vale para a loja.

Pré-requisitos técnicos quando for liberado

1. A conexão wBuy precisa estar ativa e com credencial válida.
2. O pedido deve ter sido convertido no CControle e continuar reconhecido como origem wBuy.
3. A venda precisa estar autorizada; nota em edição, rejeitada ou pendente não é enviada.
4. O XML precisa existir e a Base das URLs de XML e DANFE precisa ser HTTPS pública.
5. O status 14 ou 17 precisa estar confirmado pelo suporte técnico da wBuy.

Falhas mais comuns

• NF-e ainda não aprovada: conclua a transmissão fiscal antes.
• XML não encontrado: revise a emissão e o armazenamento do XML.
• URL sem HTTPS: a wBuy precisa conseguir baixar XML e DANFE pela internet.
• Credencial recusada: reconecte a loja antes de tentar devolver a nota.

Próximo passo

Em caso de dúvida de configuração, envie evidências seguras ao suporte, sem credenciais.

Revisado em: 24/08/2026.