rev1-2026-05-16

GerarNFSdeNF

Action que gera NF de Serviço a partir de uma NF de origem (SF1/SF2) via função MaNfs2Nfs nativa do TOTVS. Endpoint single-POST — não tem CRUD nem GET.

Ação não idempotente. Cada POST tenta criar uma nova NF de Serviço. Reexecução com mesmos params pode gerar duplicidade — controlar no chamador.

Vinculação com o ERP

Função TOTVSMaNfs2NfsGeração NFS a partir de NF

Wrapper AdvPLU_FT2NFExcsrc/lib/FAT/FT2NFEXC.prw

Fonte RESTWsNfsDoNf.prwsrc/api/GerarNFSdeNF/

Tabela origemSF1/SF2NF de entrada ou saída

Tabela destinoSF3 / SF1NFSNF de Serviço gerada

TipoActionSem GET/PUT/DELETE

Dependências

NF origem

SF1 ou SF2 + série/número

Deve existir e estar com status compatível com geração de NFS.

Cliente/Fornecedor

SA1/SA2 + loja

cCliFor + cLoja devem casar com a NF origem.

Série NFS

cSerNfs

Série usada na NF de Serviço gerada.

Convenções

Envelope canônico. { success, message, data }.

Action, não CRUD. Não tem GET, PUT, DELETE. Apenas POST que dispara a geração.

Whitelist de params. Body aceita serieOrigem, numeroOrigem, cliFor, loja, serieNfs (mapeados para os args do MaNfs2Nfs).

Operação

Geração de NFS a partir de NF.

POST/WsNfsDoNfGera NF de Serviço a partir de NF origem

Descrição

Aciona MaNfs2Nfs com os parâmetros da NF origem; retorna a chave da NFS gerada em data.

Cenário

Request body

serieOrigemstring · obrigatório

Série da NF origem (SF1/SF2).

numeroOrigemstring · obrigatório

Número da NF origem.

cliForstring · obrigatório

Cliente/Fornecedor (SA1/SA2).

lojastring · obrigatório

Loja.

serieNfsstring · obrigatório

Série da NFS a gerar.

Gerar NFS. A partir de NF saída série 1 número 000001234, cliente 000001/01.

Request

POST https://erpapi.jetme.com.br/api/99/01/WsNfsDoNf

{
  "serieOrigem": "1",
  "numeroOrigem": "000001234",
  "cliFor": "000001",
  "loja": "01",
  "serieNfs": "UN"
}

Respostas

200

NFS gerada. data traz chave/número da NFS.

400

Body inválido/incompleto.

422

Erro MaNfs2Nfs (NF origem inválida, status incompatível etc).

Schemas

Componentes do contrato

GerarNFSPayload

object

Payload da action — mapeia diretamente aos 5 args do MaNfs2Nfs.

serieOrigemstring · obrigatório

Série da NF origem.

numeroOrigemstring · obrigatório

Número da NF origem.

cliFor, lojastring · obrigatório

Cliente/Fornecedor + loja (SA1/SA2).

serieNfsstring · obrigatório

Série da NFS a gerar.

EnvelopeSucesso

object

Envelope canônico. data traz chave da NFS gerada.

success/message/data

Padrão.

EnvelopeErro

object

success=false + message.

message

Causa do erro (e.g. "NF origem nao encontrada").

Cenários

1-pra-1 com YAML.

gerar

POST /WsNfsDoNf

Geração canônica a partir de NF origem.

5 args do MaNfs2Nfs

série/número origem + cliFor/loja + série NFS destino.

Pendências conhecidas (rev2)

Não idempotente. Reexecução pode duplicar NFS — chamador deve controlar.

Sem GET de status. Para conferir a NFS gerada, consultar SF3 via SQL ou endpoint próprio.