rev1-2026-05-16

GerarNFSdePV

Action que gera NF de Serviço a partir de uma NF de origem (SC5/SC6) via função MaPvlNfs 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 TOTVSMaPvlNfsGeração NFS a partir de NF

Wrapper AdvPLU_FTPVNFEXsrc/lib/FAT/FTPVNFEX.prw

Fonte RESTWsNfsDoPv.prwsrc/api/GerarNFSdePV/

Tabela origemSC5/SC6NF de entrada ou saída

Tabela destinoSF3 / SF1NFSNF de Serviço gerada

TipoActionSem GET/PUT/DELETE

Dependências

Pedido 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 Pedido 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 pedidoOrigem, itemOrigem, cliFor, loja, serieNfs (mapeados para os args do MaPvlNfs).

Operação

Geração de NFS a partir de NF.

POST/WsNfsDoPvGera NF de Serviço a partir de Pedido origem

Descrição

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

Cenário

Request body

pedidoOrigemstring · obrigatório

Série da Pedido de Venda (SC5).

itemOrigemstring · obrigatório

Número da Pedido 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/WsNfsDoPv

{
  "pedidoOrigem": "1",
  "itemOrigem": "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 MaPvlNfs (Pedido origem inválida, status incompatível etc).

Schemas

Componentes do contrato

GerarNFSPayload

object

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

pedidoOrigemstring · obrigatório

Série da Pedido origem.

itemOrigemstring · obrigatório

Número da Pedido 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. "Pedido origem nao encontrada").

Cenários

1-pra-1 com YAML.

gerar

POST /WsNfsDoPv

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

5 args do MaPvlNfs

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.