Navegar na documentação

Enviar notas

Webhook do ERP

Um link exclusivo da sua empresa. O ERP faz um POST nele a cada nota autorizada, e a nota é simulada na hora.

Criar o link

  1. Na plataforma, abra Integrações → Webhooks e clique em Novo webhook.
  2. Dê um nome (por exemplo, “ERP matriz”) e, se quiser, escolha um cenário. Sem cenário, vale o padrão da empresa.
  3. Copie o link. Ele aparece uma única vez: guardamos só um hash. Se perder, crie outro e revogue o antigo.
O link é a credencial. Trate-o como uma senha: não publique em repositórios nem em logs. Um link vazado se resolve revogando-o na plataforma, o que vale na hora.

Enviar a nota

POST no link, com o XML no corpo e Content-Type: application/xml. Use o XML autorizado (com nfeProc) ou só a NFe.

# o próprio link é a credencial: não precisa de chave
curl -X POST "https://app.marco33.com.br/w/wh_SEU_TOKEN" \
  -H "Content-Type: application/xml" \
  --data-binary @nota.xml

Outros formatos aceitos

Content-TypeCorpo
application/xml ou text/xmlUm XML (até 2 MB): nota ou evento de cancelamento.
multipart/form-dataAté 500 XMLs no campo arquivos.
application/json{ "documentos": [ … ] } no formato canônico (ver API).

Resposta

200 OK
{
  "simulacaoId": "8e2b0c4e-…",
  "documentos": 1,
  "rejeitados": [],
  "status": [{ "id": "35260311222333000181550010000012341000012345", "status": "SIMULADO", "efeito": "soma" }],
  "cancelamentos": []
}

O detalhe completo fica na plataforma, em Simulações, e na API, em GET /v1/simulacoes/{simulacaoId}.

Erros e novas tentativas

StatusSignificadoO que o ERP deve fazer
200Recebida. XML inválido vem em rejeitados.Nada.
400Corpo vazio ou formato não reconhecido.Corrigir o envio. Não repetir igual.
404Link inexistente ou revogado.Parar e avisar o responsável.
429Limite por minuto ou cota do mês atingidos.Repetir depois do tempo em Retry-After.
503Motor de cálculo indisponível no momento.Repetir em alguns minutos, com espera crescente.
Reenviar a mesma nota não duplica o painel, que considera a simulação mais recente de cada chave de acesso. Mas cada envio conta na cota mensal.

Boas práticas

  • Envie depois da autorização, de forma assíncrona: a emissão não deve esperar pelo Marco33.
  • Use um link por origem (matriz, filial, e-commerce), para separar os dados e revogar um sem afetar os outros.
  • Ao cancelar uma nota, envie também o evento de cancelamento (procEventoNFe) para o mesmo link: a nota sai do painel, mesmo que tenha sido simulada antes.
  • Com os CNPJs cadastrados em Conta e privacidade, pode enviar vendas, compras e devoluções: o Marco33 compara a raiz do CNPJ com emitente e destinatário para decidir o que entra nos totais. Sem CNPJ cadastrado, envie apenas as próprias notas de saída, pois saídas de fornecedores podem contar como vendas suas (veja tipos de nota).
PróximoAPI REST