rev1-2026-05-16

ReprocLivrosFiscais

Action que gera NF de Serviço a partir de uma NF de origem (SF1/SF2) via função MATA930 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 TOTVSMATA930Reprocessamento a partir de NF

Wrapper AdvPLU_MT930Excsrc/lib/FAT/MT930EXC.prw

Fonte RESTWsMt930.prwsrc/api/ReprocLivrosFiscais/

Tabela origemSF1/SF2NF de entrada ou saída

Tabela destinoSF3 / SF1NFSNF de Serviço gerada

TipoActionSem GET/PUT/DELETE

Dependências

livro

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 livro.

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 MATA930).

Operação

Geração de NFS a partir de NF.

POST/WsMt930/{acao}Gera NF de Serviço a partir de livro

Descrição

Aciona MATA930 com os parâmetros da livro; retorna a chave da NFS gerada em data.

Cenário

Request body

serieOrigemstring · obrigatório

Série da livro (SF1/SF2).

numeroOrigemstring · obrigatório

Número da livro.

cliForstring · obrigatório

Cliente/Fornecedor (SA1/SA2).

lojastring · obrigatório

Loja.

serieNfsstring · obrigatório

Série da NFS a gerar.

Reprocessar Livros. 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/WsMt930/{acao}

{
  "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 MATA930 (livro inválida, status incompatível etc).

Schemas

Componentes do contrato

GerarNFSPayload

object

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

serieOrigemstring · obrigatório

Série da livro.

numeroOrigemstring · obrigatório

Número da livro.

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. "livro nao encontrada").

Cenários

1-pra-1 com YAML.

gerar

POST /WsMt930/{acao}

Geração canônica a partir de livro.

5 args do MATA930

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.