Integre seu sistema com a nossa API

Envie o XML da NF-e e receba o DANFE em PDF de volta, direto no seu ERP, e-commerce ou sistema interno — em segundos, com uma chamada HTTP simples.

Ver exemplo de envio (POST) Ver exemplo de consulta (GET)

Peça sua chave de API

Crie uma conta e solicite acesso à API — o Super Admin libera um token Bearer exclusivo da sua empresa.

Envie o XML (POST)

Seu sistema envia o XML da NF-e autenticado com o token e recebe o DANFE em PDF já na resposta.

Consulte quando quiser (GET)

Precisa reobter o PDF depois? Consulte pelo ID da nota e receba o DANFE de novo, sem reenviar o XML.

POST

Enviar o XML e receber o DANFE

Envie o XML em multipart/form-data no campo xml. A resposta já traz o DANFE em PDF, codificado em base64, no campo pdf_base64.

curl -X POST "https://seudominio.com.br/api/v1/danfe" \
  -H "Authorization: Bearer SEU_TOKEN_DE_API" \
  -H "Accept: application/json" \
  -F "xml=@/caminho/para/nota.xml"

<?php

$xmlPath = '/caminho/para/nota.xml';

$ch = curl_init('https://seudominio.com.br/api/v1/danfe');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer SEU_TOKEN_DE_API',
        'Accept: application/json',
    ],
    CURLOPT_POSTFIELDS => [
        'xml' => new CURLFile($xmlPath, 'text/xml'),
    ],
]);

$response = json_decode(curl_exec($ch), true);
curl_close($ch);

if ($response['status'] === 'processed') {
    file_put_contents('danfe.pdf', base64_decode($response['pdf_base64']));
}

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "SEU_TOKEN_DE_API");

using var form = new MultipartFormDataContent();
var xmlBytes = await File.ReadAllBytesAsync("nota.xml");
form.Add(new ByteArrayContent(xmlBytes), "xml", "nota.xml");

var response = await client.PostAsync("https://seudominio.com.br/api/v1/danfe", form);
var json = await response.Content.ReadFromJsonAsync<JsonElement>();

if (json.GetProperty("status").GetString() == "processed")
{
    var pdfBytes = Convert.FromBase64String(json.GetProperty("pdf_base64").GetString()!);
    await File.WriteAllBytesAsync("danfe.pdf", pdfBytes);
}

import base64
import requests

url = "https://seudominio.com.br/api/v1/danfe"
headers = {"Authorization": "Bearer SEU_TOKEN_DE_API"}

with open("nota.xml", "rb") as xml_file:
    response = requests.post(url, headers=headers, files={"xml": xml_file})

data = response.json()

if data["status"] == "processed":
    with open("danfe.pdf", "wb") as pdf_file:
        pdf_file.write(base64.b64decode(data["pdf_base64"]))

async function converterParaDanfe(xmlFile) {
  const formData = new FormData();
  formData.append('xml', xmlFile);

  const response = await fetch('https://seudominio.com.br/api/v1/danfe', {
    method: 'POST',
    headers: {
      Authorization: 'Bearer SEU_TOKEN_DE_API',
      Accept: 'application/json',
    },
    body: formData,
  });

  return response.json();
}

function UploadDanfe() {
  const handleChange = (event) => {
    const file = event.target.files[0];
    if (file) converterParaDanfe(file).then(console.log);
  };

  return <input type="file" accept=".xml" onChange={handleChange} />;
}

Resposta de exemplo — nenhuma chamada real é feita aqui.

Resposta simulada · 200 OK

{
  "id": 4821,
  "status": "processed",
  "pdf_base64": "JVBERi0xLjMKMyAwIG9iago8PC9UeXBlL1BhZ2Vz..."
}

GET

Consultar uma nota já convertida

Use o id retornado no envio para reconsultar a nota a qualquer momento. Quando ela já estiver processada, a resposta também traz o pdf_base64 — útil para reobter o DANFE sem reenviar o XML.

curl -X GET "https://seudominio.com.br/api/v1/danfe/123" \
  -H "Authorization: Bearer SEU_TOKEN_DE_API" \
  -H "Accept: application/json"

<?php

$notaId = 123;

$ch = curl_init("https://seudominio.com.br/api/v1/danfe/{$notaId}");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer SEU_TOKEN_DE_API',
        'Accept: application/json',
    ],
]);

$response = json_decode(curl_exec($ch), true);
curl_close($ch);

if ($response['status'] === 'processed' && isset($response['pdf_base64'])) {
    file_put_contents('danfe.pdf', base64_decode($response['pdf_base64']));
}

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "SEU_TOKEN_DE_API");

var notaId = 123;
var response = await client.GetAsync($"https://seudominio.com.br/api/v1/danfe/{notaId}");
var json = await response.Content.ReadFromJsonAsync<JsonElement>();

if (json.GetProperty("status").GetString() == "processed" && json.TryGetProperty("pdf_base64", out var pdfProp))
{
    var pdfBytes = Convert.FromBase64String(pdfProp.GetString()!);
    await File.WriteAllBytesAsync("danfe.pdf", pdfBytes);
}

import base64
import requests

nota_id = 123
url = f"https://seudominio.com.br/api/v1/danfe/{nota_id}"
headers = {"Authorization": "Bearer SEU_TOKEN_DE_API"}

response = requests.get(url, headers=headers)
data = response.json()

if data["status"] == "processed" and "pdf_base64" in data:
    with open("danfe.pdf", "wb") as pdf_file:
        pdf_file.write(base64.b64decode(data["pdf_base64"]))

async function consultarDanfe(notaId) {
  const response = await fetch(`https://seudominio.com.br/api/v1/danfe/${notaId}`, {
    headers: {
      Authorization: 'Bearer SEU_TOKEN_DE_API',
      Accept: 'application/json',
    },
  });

  return response.json();
}

function StatusDanfe({ notaId }) {
  const [nota, setNota] = React.useState(null);

  React.useEffect(() => {
    consultarDanfe(notaId).then(setNota);
  }, [notaId]);

  return <pre>{nota ? JSON.stringify(nota, null, 2) : 'Carregando...'}</pre>;
}

Resposta de exemplo — nenhuma chamada real é feita aqui.

Resposta simulada · 200 OK

{
  "id": 123,
  "status": "processed",
  "numero": "958270",
  "chave_acesso": "35260812345678000195550010000000011000000015",
  "pdf_base64": "JVBERi0xLjMKMyAwIG9iago8PC9UeXBlL1BhZ2Vz..."
}

Pronto para integrar?

Crie sua conta, entre em Solicitação de Acesso à API e comece a converter DANFEs direto do seu sistema.

Testar 7 dias grátis