rev4-2026-05-13 Protheus 12.1.33

AutorizacaoEntrega

CRUD em SC7 (Pedido de Compras / Autorização de Entrega) via rotina automática MATA120 — modelo 2 (cabeçalho + itens convivem na mesma tabela). O 1º parâmetro nTipoDoc é inferido a partir de SB1->B1_CONTRAT do produto do 1º item: S/A → Autorização de Entrega (modo 2, exige Contrato em SC3); demais → Pedido de Compras (modo 1, livre ou vinculado a SC1). C7_NUM é gerado pelo servidor (GetSXENum + ConfirmSX8) no POST.

Bloqueio TOTVS: tabela SC7 — bloqueio relevante esta em SB1 (produto) e SA2 (fornecedor).

Vinculação com o ERP

Tabela mestre SC7 Pedidos / Autorizações (capa + itens no modelo 2)

Rotina automática MATA120 8 parâmetros · PCOM04018

Wrapper AdvPL U_MT120Exc src/lib/MAT/MT120EXC.prw

Operações & modos

POST Op=3 · nTipoDoc 1|2 PUT Op=4 DEL Op=5

Dependências de ambiente

Cadastro · produto

SB1 · B1_CONTRAT

define nTipoDoc do MATA120
"S"/"A" = Autorização de Entrega (modo 2, exige Contrato SC3)
demais = Pedido de Compras (modo 1, livre ou vinculado a SC1)

Contrato · condicional

SC3 (Contrato de Parceria)

exigido quando produto tem B1_CONTRAT in (S, A)
gravado via MATA125; vínculo no item por C7_NUMSC/C7_ITEMSC

Solicitação · opcional

SC1 (Solicitação de Compras)

PC livre pode amarrar item à SC1 via C7_NUMSC/C7_ITEMSC
validado quando produto tem B1_CONTRAT em (N, vazio)

Sequência

SX8 · numeração C7_NUM

GetSXENum("SC7","C7_NUM") + DbSeek em loop + ConfirmSX8
retornado em data.numero no POST · RollBackSX8 em erro

Adiantamento · pré-requisito

SE2 (PA · Pagamento Antecipado)

título PA deve existir em SE2 antes do POST/PUT
payload adiantamento[] alimenta o 8º parâmetro aAdtPC de MATA120

Resolução automática

C7_REC_WT

obrigatório em Op=4/Op=5
endpoint preenche via aScan por C7_ITEM (PUT) ou varredura completa (DELETE)

Convenções

PC vs AE inferido pelo produto. O endpoint olha SB1->B1_CONTRAT do produto do 1º item para decidir nTipoDoc do MATA120 (1 = Pedido de Compras, 2 = Autorização de Entrega). Todos os itens da chamada devem resolver para o mesmo modo — payload misto retorna 422.

Numeração automática. No POST o cliente passa o path-param {numero} como placeholder (recomenda-se "auto"); o servidor gera C7_NUM via GetSXENum + loop DbSeek/ConfirmSX8 e devolve em data.numero. O placeholder é ignorado.

Op=4 e Op=5 exigem C7_REC_WT. O endpoint resolve automaticamente: no PUT, faz aScan em SC7 filtrado por C7_NUM casando por C7_ITEM do payload; no DELETE, varre a SC7 inteira e repõe a grade. Em chamadas diretas ao wrapper U_MT120Exc, o caller é responsável por popular o campo.

Modelo de descontos. Item suporta C7_VLDESC (valor absoluto) e/ou C7_DESC (percentual) — podem ser combinados, MATA120 soma os efeitos. Cabeçalho aceita C7_DESC1/C7_DESC2/C7_DESC3 (percentuais aplicados em cadeia, cada um sobre o valor já descontado pelo anterior).

Vínculo C7_NUMSC/C7_ITEMSC. A tabela referenciada varia conforme B1_CONTRAT: (N, vazio) → SC1 (Solicitação de Compras); (S, A) → SC3 (Contrato de Parceria). O endpoint escolhe a tabela correta e devolve 422 quando o vínculo informado não existe.

PUT em modo PC=1 com pendência conhecida. A revisão atual (rev3) ainda devolve 500 em alterações de PC livre por dependência de aRatCC (Rateio por Centro de Custo) no MATA120 Op=4. AE (nTipoDoc=2) é aceita normalmente no PUT. Ver Pendências conhecidas — _prep/wsmata120/_scratch/PEND-rateio-cc-projeto.md.

Datas. C7_EMISSAO e C7_DATPRF aceitam string AAAAMMDD no payload. Default de C7_EMISSAO = dDataBase quando omitido. Sem suporte editorial a YYYY-MM-DD nesta revisão.

Pendências conhecidas (rev3)

PUT PC=1 retorna 500. Alterações em pedidos cujo produto tem B1_CONTRAT em (N, vazio) caem em stack do MATA120 Op=4 (aRatCC[1][2][0]). Indício de que a rotina exige rateio mesmo na alteração. Workaround atual: DELETE + POST. PUT em AE (nTipoDoc=2) funciona.

Rateios não expostos. aRatCC (Centro de Custo via SCH) e aRatPrj (Projeto via AJ7, SIGAPRJ v11+) ainda não fazem parte do payload. Estrutura mapeada em src/api/AutorizacaoEntrega/MATA120-PCOM04018.md.

Aprovação de PC. MATA120 não cobre aprovação (op=7). Aprovação passa por rotina própria do PCP (ADV0066 · SIGAGSP) — fora do escopo deste endpoint.

Moeda diferente de 1. Quando C7_MOEDA != 1, MATA120 exige C7_TXMOEDA no cabeçalho (TDN pageId 322152451). Não tratado nesta revisão — assume moeda 1 (real).

DELETE de SC7 já recebida. Não há checagem editorial para devolver 409. Cabe ao MATA120 Op=5 rejeitar via NomeAutoLog — cliente recebe 422.

AutorizacaoEntrega

CRUD por C7_NUM (modelo 2 · capa + itens)

POST /WsSC7/INCLUIR/{numero} Inclui PC (modo 1) ou AE (modo 2)

Descrição

Inclui Pedido de Compras (nTipoDoc=1) ou Autorização de Entrega (nTipoDoc=2) via MATA120 em modo 3 (MODEL_OPERATION_INSERT). O endpoint infere o modo a partir de SB1->B1_CONTRAT do produto do 1º item. Numeração C7_NUM gerada pelo servidor.

Payload cabecalho + itens[] (mínimo 1 item).
Bloco opcional adiantamento[] alimenta aAdtPC; pré-requisito: PA cadastrado em SE2.
Descontos: item (C7_VLDESC e/ou C7_DESC) e cabeçalho (C7_DESC1/2/3).

Path parameter

numero string · path · obrigatório

Placeholder — C7_NUM real é gerado pelo servidor e devolvido em data.numero. Use "auto" para deixar a intenção explícita.

Request body

application/json SC7Payload · obrigatório

Envelope com cabecalho (campos do whitelist CAMPOS_CAB_ALLOW) e itens[] (whitelist CAMPOS_ITEM_ALLOW). Schema em SC7Payload.

Cenário 1 — Pedido de Compras LIVRE (sem SC1 e sem contrato). Produto PROD001 com B1_CONTRAT em (N, vazio). Fixture: fixtures/create.json.

RequestHTTP/1.1 · application/json

POST https://erpapi.jetme.com.br/api/99/01/WsSC7/INCLUIR/auto
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Content-Type: application/json
Accept: application/json

{
  "cabecalho": {
    "C7_FORNECE": "000002",
    "C7_LOJA": "01",
    "C7_EMISSAO": "20260507",
    "C7_COND": "000",
    "C7_CONTATO": "PCLIVRE",
    "C7_FILENT": "01"
  },
  "itens": [
    {
      "C7_PRODUTO": "PROD001",
      "C7_QUANT": 3,
      "C7_PRECO": 10.0,
      "C7_TOTAL": 30.0,
      "C7_LOCAL": "00"
    }
  ]
}

Cenário 2 — PC com Solicitação de Compras. Vínculo via C7_NUMSC/C7_ITEMSC apontando para SC1 válida. Fixture: fixtures/create-com-sc.json.

RequestHTTP/1.1 · application/json

POST https://erpapi.jetme.com.br/api/99/01/WsSC7/INCLUIR/auto
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Content-Type: application/json
Accept: application/json

{
  "cabecalho": {
    "C7_FORNECE": "000002",
    "C7_LOJA": "01",
    "C7_EMISSAO": "20260511",
    "C7_COND": "000",
    "C7_CONTATO": "PCCOMSC",
    "C7_FILENT": "01"
  },
  "itens": [
    {
      "C7_PRODUTO": "PROD002",
      "C7_QUANT": 100,
      "C7_PRECO": 10.0,
      "C7_TOTAL": 1000.0,
      "C7_LOCAL": "00",
      "C7_NUMSC": "000002",
      "C7_ITEMSC": "0001"
    }
  ]
}

Cenário 3 — Autorização de Entrega com Contrato de Parceria. Produto MP02PARCERIA tem B1_CONTRAT="S" → nTipoDoc=2 automaticamente. Vínculo aponta para SC3 (gravada via MATA125). Fixture: fixtures/create-com-contrato.json.

RequestHTTP/1.1 · application/json

POST https://erpapi.jetme.com.br/api/99/01/WsSC7/INCLUIR/auto
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Content-Type: application/json
Accept: application/json

{
  "cabecalho": {
    "C7_FORNECE": "000003",
    "C7_LOJA": "01",
    "C7_EMISSAO": "20260507",
    "C7_COND": "000",
    "C7_CONTATO": "PCCONTRA",
    "C7_FILENT": "01"
  },
  "itens": [
    {
      "C7_PRODUTO": "MP02PARCERIA",
      "C7_QUANT": 3,
      "C7_PRECO": 10.0,
      "C7_TOTAL": 30.0,
      "C7_LOCAL": "00",
      "C7_NUMSC": "000001",
      "C7_ITEMSC": "0001"
    }
  ]
}

Desconto cabeçalho em cadeia — C7_DESC1=10, C7_DESC2=20, C7_DESC3=50. Aplicados em cascata, distribuídos automaticamente sobre os itens. Fixture: fixtures/create-desc-cabec.json.

RequestHTTP/1.1 · application/json

POST https://erpapi.jetme.com.br/api/99/01/WsSC7/INCLUIR/auto
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Content-Type: application/json
Accept: application/json

{
  "cabecalho": {
    "C7_FORNECE": "000002",
    "C7_LOJA": "01",
    "C7_EMISSAO": "20260511",
    "C7_COND": "000",
    "C7_CONTATO": "DESCCAB",
    "C7_FILENT": "01",
    "C7_DESC1": 10,
    "C7_DESC2": 20,
    "C7_DESC3": 50
  },
  "itens": [
    { "C7_PRODUTO": "PROD001", "C7_QUANT": 10, "C7_PRECO": 100.0, "C7_TOTAL": 1000.0, "C7_LOCAL": "00" },
    { "C7_PRODUTO": "PROD001", "C7_QUANT": 20, "C7_PRECO": 100.0, "C7_TOTAL": 2000.0, "C7_LOCAL": "00" }
  ]
}

Desconto item (percentual) — C7_DESC=20. Fixture: fixtures/create-desc-item-perc.json.

RequestHTTP/1.1 · application/json

POST https://erpapi.jetme.com.br/api/99/01/WsSC7/INCLUIR/auto
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Content-Type: application/json
Accept: application/json

{
  "cabecalho": {
    "C7_FORNECE": "000002",
    "C7_LOJA": "01",
    "C7_EMISSAO": "20260511",
    "C7_COND": "000",
    "C7_CONTATO": "DESCPRC",
    "C7_FILENT": "01"
  },
  "itens": [
    {
      "C7_PRODUTO": "PROD001",
      "C7_QUANT": 10,
      "C7_PRECO": 100.0,
      "C7_TOTAL": 1000.0,
      "C7_LOCAL": "00",
      "C7_DESC": 20
    }
  ]
}

Desconto item (valor absoluto) — C7_VLDESC=150. Fixture: fixtures/create-desc-item-vldesc.json.

RequestHTTP/1.1 · application/json

POST https://erpapi.jetme.com.br/api/99/01/WsSC7/INCLUIR/auto
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Content-Type: application/json
Accept: application/json

{
  "cabecalho": {
    "C7_FORNECE": "000002",
    "C7_LOJA": "01",
    "C7_EMISSAO": "20260511",
    "C7_COND": "000",
    "C7_CONTATO": "DESCVLD",
    "C7_FILENT": "01"
  },
  "itens": [
    {
      "C7_PRODUTO": "PROD001",
      "C7_QUANT": 10,
      "C7_PRECO": 100.0,
      "C7_TOTAL": 1000.0,
      "C7_LOCAL": "00",
      "C7_VLDESC": 150
    }
  ]
}

Com adiantamento (aAdtPC) — vincula PA pré-cadastrado em SE2. Pré-requisito: título A / PAPC01 / 1 / PA / 000002 / 01 / 100 em SE2. C7_COND="006" é a condição padrão TOTVS que permite adiantamento. Fixture: fixtures/create-com-adiantamento.json.

RequestHTTP/1.1 · application/json

POST https://erpapi.jetme.com.br/api/99/01/WsSC7/INCLUIR/auto
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Content-Type: application/json
Accept: application/json

{
  "cabecalho": {
    "C7_FORNECE": "000002",
    "C7_LOJA": "01",
    "C7_EMISSAO": "20260511",
    "C7_COND": "006",
    "C7_CONTATO": "PCCOMADT",
    "C7_FILENT": "01"
  },
  "itens": [
    {
      "C7_PRODUTO": "PROD001",
      "C7_QUANT": 1,
      "C7_PRECO": 100.0,
      "C7_TOTAL": 100.0,
      "C7_LOCAL": "00"
    }
  ],
  "adiantamento": [
    {
      "prefixo": "A",
      "num": "PAPC01",
      "parcela": "1",
      "tipo": "PA",
      "fornec": "000002",
      "loja": "01",
      "valor": 100
    }
  ]
}

Respostas

201

Pedido / Autorização incluída. Envelope CrudResponse com data.numero = C7_NUM gerado.

400

Payload malformado, itens[] vazio, ou campos obrigatórios ausentes. Tier: validation-error.

422

Validação de negócio: produto inexistente, payload misto PC+AE, vínculo C7_NUMSC/C7_ITEMSC inválido na tabela esperada (SC1 ou SC3 conforme B1_CONTRAT), PA do adiantamento inexistente em SE2, ou rejeição do MsExecAuto do MATA120 (cond. pagamento, fornecedor bloqueado, etc). Tier: business-error.

500

Erro interno (falha de numeração SX8, rollback do MATA120, etc).

PUT /WsSC7/ALTERAR/{numero} Altera SC7 existente (com C7_REC_WT auto-resolvido)

Descrição

Altera cabeçalho e/ou itens via MATA120 Op=4. O endpoint preenche C7_REC_WT automaticamente para cada item (aScan em SC7 filtrado por C7_NUM casando por C7_ITEM do payload). AUTDELETA="S" em um item marca-o para exclusão dentro do Op=4.

AE (nTipoDoc=2): PUT validado e estável.
PC (nTipoDoc=1): PUT retorna 500 nesta revisão por dependência de aRatCC — ver Pendências.

Path parameter

numero string · path · obrigatório SC7.C7_NUM

Código da SC7 (6 chars).

Request body

application/json SC7Payload · obrigatório

Cabeçalho com subset de CAMPOS_CAB_ALLOW; itens com C7_ITEM obrigatório para casar o item original.

Alteração de quantidade/total — só cabeçalho mínimo + 1 item identificado por C7_ITEM. Fixture: fixtures/update.json.

RequestHTTP/1.1 · application/json

PUT https://erpapi.jetme.com.br/api/99/01/WsSC7/ALTERAR/000001
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Content-Type: application/json
Accept: application/json

{
  "cabecalho": {
    "C7_CONTATO": "ATUALIZADO"
  },
  "itens": [
    {
      "C7_ITEM": "0001",
      "C7_PRODUTO": "PROD001",
      "C7_QUANT": 5,
      "C7_PRECO": 10.0,
      "C7_TOTAL": 50.0,
      "C7_LOCAL": "00"
    }
  ]
}

Alteração com adiantamento — PA pré-existente em SE2 (A / PAPC02 / 1 / PA / 000002 / 01 / 500). Endpoint injeta o C7_NUM atual em FIE_PEDIDO automaticamente. Fixture: fixtures/update-com-adiantamento.json.

RequestHTTP/1.1 · application/json

PUT https://erpapi.jetme.com.br/api/99/01/WsSC7/ALTERAR/000002
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Content-Type: application/json
Accept: application/json

{
  "cabecalho": {
    "C7_CONTATO": "PCADTUPD"
  },
  "itens": [
    {
      "C7_ITEM": "0001",
      "C7_PRODUTO": "PROD001",
      "C7_QUANT": 5,
      "C7_PRECO": 100.0,
      "C7_TOTAL": 500.0,
      "C7_LOCAL": "00"
    }
  ],
  "adiantamento": [
    {
      "prefixo": "A",
      "num": "PAPC02",
      "parcela": "1",
      "tipo": "PA",
      "fornec": "000002",
      "loja": "01",
      "valor": 500
    }
  ]
}

Respostas

200

SC7 alterada. Envelope CrudResponse com data.numero.

400

Payload malformado, C7_ITEM ausente em algum item, etc. Tier: validation-error.

404

C7_NUM inexistente ou C7_ITEM não encontrado na SC7. Tier: not-found.

422

Rejeição do MATA120 Op=4 (regras de negócio, condição inválida, etc). Tier: business-error.

500

Pendência conhecida em PC=1: stack aRatCC[1][2][0] no MATA120. Workaround: DELETE + POST. Em AE (modo 2) este status indica falha real interna.

DEL /WsSC7/EXCLUIR/{numero} Exclui SC7 inteira

Descrição

Exclui a SC7 inteira via MATA120 Op=5. O endpoint reproduz aItens com C7_REC_WT varrendo a tabela. MATA120 rejeita exclusão quando há recebimento associado — resposta 422 com mensagem do NomeAutoLog.

Path parameter

numero string · path · obrigatório SC7.C7_NUM

Código da SC7 (6 chars).

Cenario

Exemplo da requisicao (cenario ativo)

Exclusao integral — remove cabec + todos os itens da SC7 via MATA120 Op=5.

RequestHTTP/1.1 · sem body

DELETE https://erpapi.jetme.com.br/api/99/01/WsSC7/EXCLUIR/000001
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Accept: application/json

Respostas

200

SC7 excluída.

400

C7_NUM ausente ou inválido. Tier: validation-error.

404

SC7 inexistente. Tier: not-found.

422

SC7 com recebimento associado / dependências de baixa. Tier: business-error.

500

Erro interno.

GET /WsSC7/{numero} Consulta SC7 (cabeçalho + itens)

Descrição

Retorna a SC7 estruturada como {cabecalho, itens[]}. Aplica xFilial("SC7") e respeita o whitelist CAMPOS_CAB_GET/CAMPOS_ITEM_GET.

Path parameter

numero string · path · obrigatório SC7.C7_NUM

Código da SC7 (6 chars).

Cenario

Exemplo da requisicao (cenario ativo)

Consulta por C7_NUM — retorna envelope {cabecalho, itens[]}.

RequestHTTP/1.1 · sem body

GET https://erpapi.jetme.com.br/api/99/01/WsSC7/000001
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Accept: application/json

Respostas

200

SC7 encontrada. Envelope SC7Detalhe com data = { cabecalho, itens[] }.

400

numero fora do pattern.

404

SC7 inexistente. Tier: not-found.

500

Erro interno.

Listagem

Paginação por C7_NUM (uma linha por SC7)

GET /WsSC7/_list Lista SC7s com filtros e paginação

Descrição

Lista cabeçalhos distintos de SC7. Devolve uma linha por C7_NUM com C7_FORNECE, C7_LOJA e C7_EMISSAO. Filtros são opcionais e podem ser combinados.

Query parameters

num string · query · opcional SC7.C7_NUM

Prefixo de C7_NUM.

fornece string · query · opcional SC7.C7_FORNECE

Filtro por C7_FORNECE (igualdade, case-insensitive).

emissao string · query · opcional SC7.C7_EMISSAO

Data de emissão (AAAAMMDD).

page integer · query · opcional

Página (default 1).

pageSize integer · query · opcional

Tamanho da página (default 50, máx 500).

Cenario

Exemplo da requisicao (cenario ativo)

Listagem paginada — filtros opcionais combinaveis.

Request · filtro por fornecedorHTTP/1.1 · sem body

GET https://erpapi.jetme.com.br/api/99/01/WsSC7/_list?fornece=000002&page=1&pageSize=50
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Accept: application/json

Request · por data de emissãoHTTP/1.1 · sem body

GET https://erpapi.jetme.com.br/api/99/01/WsSC7/_list?emissao=20260511
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Accept: application/json

Respostas

200

Página de SC7s. Envelope com data (array de SC7ListItem), page, pageSize, count.

400

Parâmetro fora do domínio (pageSize > 500, etc).

500

Erro interno.

Schemas

Definições canônicas — campos com origem SX3 rastreável

SC7Payload

object

Payload aceito em POST e PUT. Envelope com cabecalho (whitelist CAMPOS_CAB_ALLOW), itens[] (whitelist CAMPOS_ITEM_ALLOW, mínimo 1 item) e opcional adiantamento[] (Adiantamento).

cabecalho · object

C7_FORNECEstring · obrigatório (POST)SC7.C7_FORNECE

Código do fornecedor (chave SA2 com C7_LOJA).

C7_LOJAstring · obrigatório (POST)SC7.C7_LOJA

Loja do fornecedor. Default "01".

C7_EMISSAOstring · opcionalSC7.C7_EMISSAO

Data de emissão (AAAAMMDD). Default = dDataBase.

C7_CONDstring · opcionalSC7.C7_COND

Condição de pagamento (SE4). "006" recomendada para uso com adiantamento.

C7_CONTATOstring · opcionalSC7.C7_CONTATO

Nome do contato.

C7_FILENTstring · opcionalSC7.C7_FILENT

Filial de entrega.

C7_OBSstring · opcionalSC7.C7_OBS

Observação.

C7_TIPOstring · opcionalSC7.C7_TIPO

Tipo do PC.

C7_TPOPstring · opcionalSC7.C7_TPOP

Tipo de operação.

C7_DESC1number · opcionalSC7.C7_DESC1

Desconto cabeçalho (percentual, 1ª camada da cadeia).

C7_DESC2number · opcionalSC7.C7_DESC2

Desconto cabeçalho (percentual sobre o valor já descontado por C7_DESC1).

C7_DESC3number · opcionalSC7.C7_DESC3

Desconto cabeçalho (percentual, 3ª camada da cadeia).

C7_TPFRETEstring · opcionalSC7.C7_TPFRETE

Tipo de frete.

C7_FRETEnumber · opcionalSC7.C7_FRETE

Valor do frete.

itens[] · array (minItems: 1)

C7_ITEMstring · obrigatório em PUTSC7.C7_ITEM

Sequencial do item ("0001", "0002", ...). No PUT é a chave de casamento com a SC7 existente.

C7_PRODUTOstring · obrigatórioSC7.C7_PRODUTO

B1_COD existente em SB1. Define o modo PC/AE pelo B1_CONTRAT.

C7_QUANTnumber · obrigatórioSC7.C7_QUANT

Quantidade.

C7_PRECOnumber · opcionalSC7.C7_PRECO

Preço unitário.

C7_TOTALnumber · opcionalSC7.C7_TOTAL

Valor total da linha. Quando omitido, MATA120 recalcula.

C7_LOCALstring · opcionalSC7.C7_LOCAL

Armazém.

C7_NUMSCstring · opcionalSC7.C7_NUMSC

Documento de origem. Aponta para SC1 quando B1_CONTRAT em (N, vazio) ou para SC3 quando (S, A).

C7_ITEMSCstring · opcionalSC7.C7_ITEMSC

Item de origem (par com C7_NUMSC).

C7_DATPRFstring · opcionalSC7.C7_DATPRF

Data prevista de entrega (AAAAMMDD).

C7_TESstring · opcionalSC7.C7_TES

Código da TES.

C7_OBSstring · opcionalSC7.C7_OBS

Observação do item.

C7_VLDESCnumber · opcionalSC7.C7_VLDESC

Desconto do item em valor absoluto. Combinável com C7_DESC.

C7_DESCnumber · opcionalSC7.C7_DESC

Desconto do item em percentual. Combinável com C7_VLDESC (MATA120 soma os efeitos).

AUTDELETAstring · opcional

Em PUT, marca o item para exclusão dentro do Op=4.

S

SC7Detalhe

object · envelope

Envelope da resposta do GET /WsSC7/{numero}. data contém { cabecalho: object, itens: object[] } com os campos do whitelist CAMPOS_CAB_GET/CAMPOS_ITEM_GET.

successboolean

Sempre true.

messagestring

Mensagem de sucesso.

data.cabecalhoobject

Capa da SC7: C7_NUM, C7_EMISSAO, C7_FORNECE, C7_LOJA, C7_COND, C7_CONTATO, C7_FILENT, C7_TIPO, C7_TPOP, C7_DESC1/2/3, C7_TPFRETE, C7_FRETE.

data.itens[]array

Itens da SC7: C7_ITEM, C7_PRODUTO, C7_QUANT, C7_PRECO, C7_TOTAL, C7_LOCAL, C7_NUMSC, C7_ITEMSC, C7_DATPRF, C7_VLDESC, C7_DESC.

SC7ListItem

object

Linha retornada por /WsSC7/_list. Uma linha por C7_NUM (cabeçalho distinct — sem itens).

C7_NUMstringSC7.C7_NUM

Número da SC7.

C7_FORNECEstringSC7.C7_FORNECE

Fornecedor.

C7_LOJAstringSC7.C7_LOJA

Loja do fornecedor.

C7_EMISSAOstringSC7.C7_EMISSAO

Data de emissão (AAAAMMDD).

Adiantamento

object

Entrada do bloco opcional adiantamento[] — alimenta o 8º parâmetro aAdtPC do MATA120. Pré-requisito: título PA já cadastrado em SE2 com os mesmos prefixo/num/parcela/tipo/fornec/loja. No POST, FIE_PEDIDO vai vazio; no PUT, o endpoint injeta o C7_NUM atual.

prefixostring · obrigatórioSE2.FIE_PREFIX

Prefixo do título.

numstring · obrigatórioSE2.FIE_NUM

Número do PA (Pagamento Antecipado).

parcelastring · obrigatórioSE2.FIE_PARCEL

Parcela.

tipostring · opcionalSE2.FIE_TIPO

Tipo do título. Default "PA".

fornecstring · obrigatórioSE2.FIE_FORNEC

Fornecedor (deve casar com o do cabeçalho).

lojastring · obrigatórioSE2.FIE_LOJA

Loja do fornecedor.

valornumber · obrigatórioSE2.FIE_VALOR

Valor do adiantamento (> 0).

CrudResponse

object · envelope

Envelope padrão das respostas de POST/PUT/DELETE. data.numero traz o C7_NUM gerado no POST ou refletido no PUT.

successboolean · const: true

Sempre true em respostas de sucesso.

messagestring · obrigatório

Mensagem editorial de sucesso (ex: "Autorizacao de Entrega incluida com sucesso.").

data.numerostring · opcional

C7_NUM gerado (POST) ou alvo da operação (PUT). Ausente no DELETE.

Erro

object · envelope

Envelope padrão de erros 4xx/5xx. data pode conter o token interno da causa (ex: mensagem do NomeAutoLog do MATA120) para tratamento programático.

successboolean · const: false

Sempre false em erros.

messagestring · obrigatório

Mensagem editorial do erro (apresentável ao usuário final).

datastring · opcional

Token interno / detalhe técnico (ex: log do MsExecAuto MATA120).

Cenários

Catálogo de combinações de payload/query reconhecidas pelos métodos. Cada cenário usa o mesmo schema mas demonstra um uso típico distinto. Tier semântico no slug (-minimo, -com-*, -invalido); endpoint no type-pill.

pc-livre

POST /WsSC7/INCLUIR/{numero}

Pedido de Compras LIVRE -- produto sem B1_CONTRAT e sem vinculo a SC1. Modo MATA120 = 1 (PC), inferido pelo 1o item.

Quando usar: compra avulsa sem solicitacao previa.

pc-com-sc

POST /WsSC7/INCLUIR/{numero}

Pedido de Compras vinculado a uma Solicitacao de Compras (SC1) via C7_NUMSC+C7_ITEMSC. Modo MATA120 = 1.

Pre-requisito: SC1 existente; endpoint valida em SC1 antes do MsExecAuto.

ae-com-contrato

POST /WsSC7/INCLUIR/{numero}

Autorizacao de Entrega -- produto com B1_CONTRAT in (S,A), vinculado a Contrato de Parceria (SC3). Modo MATA120 = 2 (AE).

Pre-requisito: SC3 valida; endpoint valida em SC3 antes do MsExecAuto.

desc-cabec-cadeia

POST /WsSC7/INCLUIR/{numero}

PC com C7_DESC1/2/3 aplicados em cadeia sobre o valor bruto (TDN PCOM04018). Cada percentual incide sobre o saldo apos o anterior.

desc-item-percentual

POST /WsSC7/INCLUIR/{numero}

Desconto por item em percentual (C7_DESC).

desc-item-valor

POST /WsSC7/INCLUIR/{numero}

Desconto por item em valor absoluto (C7_VLDESC).

com-adiantamento

POST /WsSC7/INCLUIR/{numero}

PC com adiantamento em SE2 (PA) referenciado em aAdtPC.

Pre-requisito: titulo PA pre-cadastrado em SE2 para o fornecedor.

tipo-invalido

POST /WsSC7/INCLUIR/{numero}

422 -- dominio: C7_TIPO fora do Pertence("1,2"). Static fValDom rejeita antes do MATA120, devolvendo mensagem clara em vez do HELP opaco da rotina. Valores aceitos: 1 (Pedido de Compra), 2 (Autorizacao de Entrega).

tpop-invalido

POST /WsSC7/INCLUIR/{numero}

422 -- dominio: C7_TPOP fora do Pertence("FP"). Valores aceitos: F (Firme), P (Prevista).

alteracao-quantidade

PUT /WsSC7/ALTERAR/{numero}

Alteracao parcial de quantidade/preco de um item existente. C7_REC_WT e auto-resolvido pelo endpoint via C7_ITEM.

put-com-adiantamento

PUT /WsSC7/ALTERAR/{numero}

PUT trocando o adiantamento aplicado ao PC.

Aviso: retorno 500 conhecido nesta base (bug pre-existente do MATA120 com PA -- ver memoria project_handoff_2026_05_11_proxima_frente_pa).

exclusao-integral

DELETE /WsSC7/EXCLUIR/{numero}

Remove a SC7 inteira (cabec + todos os itens) via MATA120 Op=5.

Bloqueio: 422 quando ha recebimento associado (validacao do MATA120).

consulta-por-numero

GET /WsSC7/{numero}

Retorna envelope SC7Detalhe com data = {cabecalho, itens[]}.

listagem-paginada

GET /WsSC7/_list

Lista cabecalhos distintos por C7_NUM. Filtros num, fornece, emissao combinaveis. Paginacao via page/pageSize.