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
- Na plataforma, abra Integrações → Webhooks e clique em Novo webhook.
- Dê um nome (por exemplo, “ERP matriz”) e, se quiser, escolha um cenário. Sem cenário, vale o padrão da empresa.
- 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.xmlOutros formatos aceitos
| Content-Type | Corpo |
|---|---|
application/xml ou text/xml | Um XML (até 2 MB): nota ou evento de cancelamento. |
multipart/form-data | Até 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
| Status | Significado | O que o ERP deve fazer |
|---|---|---|
| 200 | Recebida. XML inválido vem em rejeitados. | Nada. |
| 400 | Corpo vazio ou formato não reconhecido. | Corrigir o envio. Não repetir igual. |
| 404 | Link inexistente ou revogado. | Parar e avisar o responsável. |
| 429 | Limite por minuto ou cota do mês atingidos. | Repetir depois do tempo em Retry-After. |
| 503 | Motor de cálculo indisponível no momento. | Repetir em alguns minutos, com espera crescente. |
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).