Pular para o conteúdo

Payloads de emissão (v2)

NFe — `POST /nfe/emissao`

Campos principais

Campo	Obrigatório	Descrição
`serie`	Sim	Série numérica (1–999)
`cfop`	Sim (na prática)	CFOP da operação (ex.: `"5.102"`)
`cliente`	Sim	CPF/CNPJ (string) de cliente cadastrado ou objeto com os dados do cliente
`itens`	Sim	Array com pelo menos 1 item
`numero`	Não	Número da nota; se vazio, é gerado automaticamente
`numero_origem`	Recomendado	Seu identificador único da venda (idempotência)
`tipo`	Não	`"S"` saída (default) ou `"E"` entrada
`finalidade`	Não	`"N"` normal (default), `"C"` complementar, `"A"` ajuste, `"D"` devolução
`valor-despesas`	Não	Default `"0.00"`
`porcentagem-desconto`	Não	Desconto sobre o total
`observacao`	Não	Até 2.000 caracteres
`data-saida` / `data-retroativa`	Não	Data de saída e flag de retroatividade (`"S"`/`"N"`)
`transporte`	Não	Objeto de transporte; se ausente, modalidade default `"9"` (sem frete)
`notas-referenciadas`	Não	Array de chaves de acesso referenciadas
`faturas`	Não	Array de faturas (`{ "valor": "...", "data": "AAAA-MM-DD" }`)

Cada item de itens:

Campo	Obrigatório	Descrição
`produto`	Sim	Referência (string) de produto cadastrado ou objeto com os dados do produto
`quantidade`	Sim	Quantidade
`valor-unitario`	Sim	Valor unitário
`desconto-unitario`	Não	Default `"0.00"`
`cfop`	Não	Herda o CFOP da nota se omitido

Exemplo

curl -X POST https://api.mysebr.com.br/nfemyse/rest/nfe/emissao \
  -H "Authorization: Token SEU_TOKEN" -H "Content-Type: application/json" \
  -d '{
    "serie": "1",
    "cfop": "5.102",
    "numero_origem": "PED-2026-00042",
    "tipo": "S",
    "finalidade": "N",
    "cliente": "12345678000199",
    "itens": [
      { "produto": "SKU-001", "quantidade": "2", "valor-unitario": "89.90" }
    ]
  }'

Objeto `transporte` (modalidade ≠ 9)

{
  "modalidade": "0",
  "transportadora": "98765432000111",
  "placa-veiculo": "ABC-1D23",
  "valor-frete": "150.00",
  "valor-seguro": "0.00",
  "peso-bruto": "5.5",
  "peso-liquido": "5.0",
  "quantidade-volume": "1",
  "especie-volume": "Caixa",
  "marca-volume": "Embalagem padrão"
}

NFCe — `POST /nfce/emissao`

Mesma base da NFe, com forma de pagamento. O campo tipo-pagamento aceita alias ou código:

Alias	Código
`dinheiro`	1
`credito`	55
`debito`	54
`outros`	56

NFSe — `POST /nfse/emissao`

Mesmo payload da NFe; o cfop é ajustado automaticamente para 5.933 (dentro do estado) ou 6.933 (fora). Envie os itens de serviço em itens.

Cancelamento e carta de correção (NFe)

Cancelamento
Carta de correção

POST /nfe/cancelamento

{ "chave": "3526...44 dígitos...", "motivo": "Motivo com 15 a 255 caracteres" }

POST /nfe/correcao

{ "chave": "3526...44 dígitos...", "motivo": "Correção com 15 a 255 caracteres" }