orders). Para os detalhes de cada
modelo de nota, veja Emissão de NF-e, Emissão
de NFC-e e Emissão de
NFS-e.
Duas formas de emitir
Há duas formas de emitir uma nota, escolhidas conforme quanto dado tributário você quer enviar:
Em ambas, a nota entra no mesmo fluxo de processamento assíncrono descrito
abaixo.
Na emissão por venda, a tributação vem da configuração da empresa
(grupos de tributação e naturezas de operação), feita no backoffice da Spedy
— não pela API.
Emissão a partir de uma venda
Ao criar uma venda (POST /v1/orders), o campo autoIssueMode decide o que
acontece com a nota:
Independentemente do modo, você também pode emitir (ou reemitir) as notas de
uma venda a qualquer momento chamando:
cURL
effectiveDate, opcional, para definir a data de competência
da nota — se omitido, usa a data original da venda.
Do payload à autorização
Como mostra o diagrama, a resposta HTTP inicial e o resultado fiscal acontecem em momentos diferentes — veja Síncrono vs assíncrono para o porquê disso e Ciclo de vida da nota para a máquina de estados completa que a nota percorre entre ocreated e o resultado
final (authorized, rejected, denied ou inContingent).
Caminhos por tipo de nota
O payload e as regras de validação variam por modelo de nota:NF-e
Nota Fiscal Eletrônica (modelo 55), para operações com produtos.
NFC-e
Nota Fiscal de Consumidor Eletrônica (modelo 65), para venda a consumidor final.
NFS-e
Nota Fiscal de Serviço Eletrônica, com regras específicas por município.
Uma mesma venda pode gerar mais de um modelo de nota (por exemplo, produto
e serviço na mesma operação) se
general.allowMultipleInvoiceModelsPerOrder estiver habilitado nas
configurações da empresa.