Comece aqui

Visão geral

A API 2MNotas segue o padrão REST. Envie e receba JSON por HTTPS usando a URL base abaixo. Todos os horários retornados seguem ISO 8601.

Base URLhttps://api.2mnotas.tech

Formato de respostaapplication/json

Segurança

Autenticação Bearer

Inclua sua API Key em cada requisição. Gere e revogue chaves na área do desenvolvedor, sem expô-las no navegador ou em repositórios públicos.

Authorization: Bearer 2mn_live_sua_chave

NF-e modelo 55

Emitir NF-e

POST/v1/nfe/emitir

Envia os dados da operação e retorna os documentos fiscais após a autorização. Use uma Idempotency-Key única para evitar emissões duplicadas.

Payload JSON

{
  "cnpj_emitente": "12.345.678/0001-90",
  "natureza_operacao": "Venda de mercadoria",
  "destinatario": {
    "cnpj": "98.765.432/0001-10",
    "razao_social": "Cliente Exemplo LTDA"
  },
  "itens": [
    {
      "descricao": "Produto Exemplo",
      "ncm": "8471.30.12",
      "quantidade": 1,
      "valor_unitario": 199.90
    }
  ]
}

200 · Resposta de sucesso

{
  "sucesso": true,
  "status": "autorizada",
  "chave_acesso": "35260912345678000190550010000001841000001840",
  "protocolo": "135260000123456",
  "danfe_url": "https://api.2mnotas.tech/v1/notas/9f2c1b7e/danfe",
  "xml_url": "https://api.2mnotas.tech/v1/notas/9f2c1b7e/xml"
}

NFC-e modelo 65

Emitir NFC-e

POST/v1/nfce/emitir

Emita um cupom fiscal com itens, consumidor opcional e forma de pagamento em uma única requisição.

Payload JSON

{
  "cnpj_emitente": "12.345.678/0001-90",
  "consumidor": {
    "cpf": "123.456.789-00"
  },
  "itens": [
    {
      "descricao": "Produto no balcão",
      "quantidade": 2,
      "valor_unitario": 24.90
    }
  ],
  "pagamento": {
    "forma": "pix",
    "valor": 49.80
  }
}

Monitoramento

Status do serviço

GET/v1/status

Consulte rapidamente a disponibilidade da API e dos serviços de autorização da SEFAZ.

200 · Resposta

{
  "status": "operacional",
  "servico": "2MNotas API",
  "sefaz": {
    "nfe": "online",
    "nfce": "online"
  },
  "timestamp": "2026-09-12T20:26:00Z"
}

Integração

Exemplos completos

Use o mesmo endpoint em qualquer linguagem capaz de fazer requisições HTTPS.

cURL

curl --request POST \
  --url https://api.2mnotas.tech/v1/nfe/emitir \
  --header 'Authorization: Bearer 2mn_live_sua_chave' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: pedido-184' \
  --data '{ "cnpj_emitente": "12.345.678/0001-90", "natureza_operacao": "Venda de mercadoria", "destinatario": { "cnpj": "98.765.432/0001-10", "razao_social": "Cliente Exemplo LTDA" }, "itens": [ { "descricao": "Produto Exemplo", "ncm": "8471.30.12", "quantidade": 1, "valor_unitario": 199.90 } ] }'

JavaScript · fetch

const response = await fetch("https://api.2mnotas.tech/v1/nfe/emitir", {
  method: "POST",
  headers: {
    "Authorization": "Bearer 2mn_live_sua_chave",
    "Content-Type": "application/json",
    "Idempotency-Key": "pedido-184"
  },
  body: JSON.stringify(payload)
});

const nota = await response.json();