AcertoInventario
Endpoint de processo que dispara a rotina automática
MATA340 para efetivar o acerto de inventário sobre documentos
previamente cadastrados em SB7. O cadastro do documento de
inventário é feito por outras rotinas (MATA275 / MATA265) —
este serviço apenas dispara o processamento e oferece
GETs de inspeção.
https://erpapi.jetme.com.br/api/99/01
Empresa 99 · Filial 01
Endpoint OAuth2
Sem credenciais? Você pode pegar o token rodando
./src/scripts/get-token.sh na biblioteca e
colar o access_token aqui no campo de refresh
(ou clique em "Logout" para limpar e voltar ao fake).
Convenções
Natureza do serviço. Este endpoint não cria documento
de inventário — apenas dispara o processamento de um
documento já existente em SB7. O cadastro do documento
(B7_DOC + itens) é responsabilidade de outras rotinas
(MATA275 / MATA265 ou inclusão direta em
ambiente de teste).
Modo de execução. O POST dispara
MATA340 sempre em modo todos os itens
(lIndividual = .F.). O modo lIndividual = .T.
da TDN exigiria varrer SB7 item-a-item via REST, o que
não se justifica para um endpoint de processo.
Idempotência. Controlada pela própria
MATA340 — B7_STATUS muda após processado.
Reprocessar um documento já efetivado retorna 422 com
motivo do NomeAutoLog, ou no-op conforme o estado do item.
O cliente não deve assumir idempotência forte; sempre
consultar B7_STATUS antes de retentar.
Path param {documento}. Aceita até 6
caracteres (TamSX3("B7_DOC")). A string PROCESSAR
é reservada como segmento de rota — não pode aparecer como valor de
{documento}. Validação devolve 400.
Paginação. /_list usa
page/pageSize (default 50, máximo
500). Listagem itera SB7 em ordem de índice 1
(B7_FILIAL+B7_DOC+...) — quando há filtro por doc,
o seek é prefixado para reduzir varredura.
Formato de datas. Filtro data e campo
B7_DATA usam string AAAAMMDD (8 dígitos, sem
separador). É o formato nativo do AdvPL (DToS), não ISO.
Processo
Disparo do acerto de inventário via MATA340Descrição
Dispara MATA340 em modo todos os itens
(lIndividual = .F.) para o documento de inventário
{documento} (B7_DOC). A rotina valida a
existência de itens em SB7 (mesmo
B7_FILIAL + B7_DOC) antes de chamar
MsExecAuto; documento sem itens vinculados devolve
404 sem disparar a rotina.
- Sem
request body— todas as informações vêm do path. - A contagem de itens devolvida em
data.itensé apurada antes do disparo (não é o retorno doMATA340).
Path parameter
TamSX3("B7_DOC")). O valor PROCESSAR é reservado e rejeitado com 400.Chamada de exemplo
POST https://erpapi.jetme.com.br/api/99/01/WsAcerto/PROCESSAR/000001 Authorization: Bearer eyJhbGciOiJIUzI1NiIs… Content-Type: application/json Accept: application/json
Respostas
RespProcessar com data.documento e data.itens (contagem antes do disparo).PROCESSAR ou maior que TamSX3("B7_DOC"). Tier: validation-error.SB7, ou encontrado sem itens vinculados. Tier: not-found.MATA340 rejeitou a operação (item já processado, saldo bloqueado, regra de negócio do NomeAutoLog). Tier: business-error.U_MT340Exc).Inspeção
Consulta de itens SB7 (read-only)Descrição
Retorna todos os itens vinculados ao documento de inventário
(SB7 com mesmo B7_FILIAL + B7_DOC). Útil
para inspecionar o que será processado antes de disparar
o POST /PROCESSAR, ou para auditar o resultado após
o processamento (campo B7_STATUS).
Subset de campos definido por CAMPOS_GET no
.prw: B7_DOC, B7_FILIAL,
B7_COD, B7_LOCAL, B7_DATA,
B7_QUANT, B7_QTSEGUM,
B7_LOTECTL, B7_NUMSERI,
B7_DTVALID, B7_STATUS.
Path parameter
/WsAcerto/_list.Chamada de exemplo
GET https://erpapi.jetme.com.br/api/99/01/WsAcerto/000001 Authorization: Bearer eyJhbGciOiJIUzI1NiIs… Accept: application/json
Respostas
TamSX3("B7_DOC").SB7. Tier: not-found.Descrição
Listagem paginada de itens de inventário (uma linha por
registro SB7) com filtros opcionais. Quando
doc é informado, faz seek prefixado pelo índice 1
para reduzir varredura. Demais filtros (produto,
local, data, status) são
aplicados em memória, após o seek.
- Subset enxuto retornado:
B7_DOC,B7_COD,B7_LOCAL,B7_DATA,B7_QUANT,B7_STATUS. - Ordenação fixa pelo índice 1 (
B7_FILIAL+B7_DOC+...).
Query parameters
B7_DOC. Quando informado, o seek é prefixado (mais eficiente que varredura completa).B7_COD, após AllTrim).B7_DATA em formato AAAAMMDD (8 dígitos, sem separador). Não é ISO.B7_STATUS. Útil para separar itens pendentes de processados.1, mínimo 1).50, máximo 500).Chamada de exemplo
GET https://erpapi.jetme.com.br/api/99/01/WsAcerto/_list?page=1&pageSize=50 Authorization: Bearer eyJhbGciOiJIUzI1NiIs… Accept: application/json
GET https://erpapi.jetme.com.br/api/99/01/WsAcerto/_list?doc=000001&status=2&pageSize=100 Authorization: Bearer eyJhbGciOiJIUzI1NiIs… Accept: application/json
GET https://erpapi.jetme.com.br/api/99/01/WsAcerto/_list?produto=PA001&data=20260507 Authorization: Bearer eyJhbGciOiJIUzI1NiIs… Accept: application/json
Respostas
Schemas
Definições canônicas — campos com origemSX3 rastreável
GET /WsAcerto/{documento}.
Subset descritivo de SB7 definido em
CAMPOS_GET no .prw.
xFilial("SB7")).SB1).NNR).AAAAMMDD (saída de DToS).AAAAMMDD).MATA340 após processado; útil para isolar pendentes via filtro ?status=.POST /PROCESSAR em sucesso. Inclui o
documento processado e a contagem de itens vinculados (apurada
antes do disparo do MATA340).
true em sucesso."Acerto processado com sucesso.".B7_DOC processado (sem padding).SB7 vinculados ao documento (contagem pré-disparo).GET /WsAcerto/{documento}. Lista todos os itens
vinculados ao documento informado.
true em sucesso.SB7 vinculados.data.itens.length).GET /WsAcerto/_list. Retorna uma página de
itens com subset enxuto (uma linha por registro SB7).
true em sucesso.PAGE_SIZE_MAX = 500).B7_DOC, B7_COD, B7_LOCAL, B7_DATA, B7_QUANT, B7_STATUS. Não retorna lote/série/validade — use GET /{documento} para o item completo.message traz o motivo
apresentável; em 422 reflete a mensagem do NomeAutoLog
do MATA340.
false em erros.U_MT340Exc (que captura NomeAutoLog via paridade CT030EXC).