Emissão de NF-e

Emite uma NF-e (modelo 55)

Tributos informados pelo seu ERP (modo: "informado", o padrão) ou calculados pela Sudrel a partir do produto cadastrado (modo: "calcular"; veja Produtos e motor fiscal). A Sudrel valida tudo antes de reservar número: erros de campo voltam juntos em 422 validacao, cada um no seu JSON Pointer; totais que não fecham com a soma dos itens também. Empresa sem os requisitos da NF-e é 412 empresa_nao_pronta (veja GET /v1/nfe/prontidao/{empresa_id}).

post/v1/nfe

Request

  • Base URL: https://api.sudrel.com.br/api
  • URL: https://api.sudrel.com.br/api/v1/nfe
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Identificador único da SUA tentativa de emissão (ex.: um UUID gerado pelo seu sistema). Mesma chave e mesmo corpo: mesma resposta, sem nota nova, por 30 dias. Mesma chave e corpo diferente: 409 nas primeiras 24 horas; depois disso, a chave vale como nova.

Preferstring
Example:wait=15

wait=N: quantos segundos a chamada acompanha a nota antes de responder 202. Padrão 10, máximo 30; wait=0 responde na hora.

X-Sudrel-Simularstring

Simulador de falhas da NF-e, só com a chave sdr_test_. Um cenário da seção Simulador de falhas (parte NF-e), por exemplo denegada ou rejeicao:778. Cenário desconhecido é 422 simulacao_invalida.

Request body

empresa_idstring required
referenciastring

Seu identificador, único por empresa e ambiente.

modo'informado' | 'calcular' | 'conferir'
operacao'venda' | 'venda_consumidor_final' | 'remessa' | 'transferencia' | 'bonificacao' | 'devolucao'

Modos calcular e conferir. Padrão venda.

subtipo'conserto' | 'demonstracao' | 'industrializacao' | 'outras' | 'comercializacao'

Remessa e devolução.

chave_referenciadastring

Chave de acesso da NF-e de origem (44 caracteres; pode ter letra com CNPJ alfanumérico). Obrigatória com finalidade devolucao ou complementar e com operacao: devolucao; aceita nas outras. Na devolução vai em cada item (det/DFeReferenciado); nas outras finalidades, em NFref/refNFe.

serieinteger

Omitida: a série da API desta empresa.

natureza_operacaostring required
tipo_operacao'saida' | 'entrada'
finalidade'normal' | 'complementar' | 'ajuste' | 'devolucao'
presenca'nao_se_aplica' | 'presencial' | 'internet' | 'telefone' | 'entrega_em_domicilio' | 'presencial_fora_do_estabelecimento' | 'outros' required
consumidor_finalboolean
intermediadorboolean

Só false nesta versão (venda pelo próprio canal).

troconumber
autorizados_xmlstring[]

CPF/CNPJ autorizados a baixar o XML.

informacoes_complementaresstring
informacoes_fiscostring

Response

Autorizada.

idstring
referenciastring nullable
status'transmitindo' | 'aguardando_confirmacao' | 'autorizada' | 'rejeitada' | 'denegada' | 'cancelada' | 'descartada' | 'contingencia_epec'
empresa_idstring
ambiente'sandbox' | 'producao'
simulacaostring nullable
modo'informado' | 'calcular' | 'conferir'
modelo55
serieinteger
numerointeger
chave_acessostring
chaves_anterioresstring[]

Chaves que a nota teve antes de uma correção num mês seguinte.

chave_referenciadastring nullable

Chave da NF-e de origem referenciada (devolução, complementar); null quando a nota não referencia nenhuma.

protocolostring nullable
emitida_emstring date-time nullable
autorizada_emstring date-time nullable
valor_totalstring nullable
regras_versaostring
criada_emstring date-time
atualizada_emstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.