Gravação de Pedidos de Venda (PED1 / PED2) — Documentação Complementar

https://<host>:<porta>/root/dicionario?userToken=<token>

Antes de gravar um pedido, os cadastros abaixo precisam existir no ERP, porque são referenciados pelo cabeçalho (PED1) ou pelos itens (PED2) e validados pelo servidor na inclusão:

Cadastro	Campo em PED1/PED2	Observação
Cliente (CLIFOR1)	CF_COD	Pessoa do tipo cliente, cadastro completo e ativo. Ver página Cadastro de Pessoas.
Tipo de Movimento (TMOV)	TM_COD	Deve ser um tipo de saída/venda compatível com CF_TIPO = 'C'. Define o tipo de documento, controle de estoque, preço e tributação. Ex.: S001.
Produto (PROD)	PD_COD	Cada item aponta para um produto cadastrado, obrigatoriamente com NCM.
Condição de Pagamento (PRAZO)	PZ_COD	Validada para o tipo C.
Forma de Pagamento (FORPAG)	FP_COD	Validada para o tipo C.
Carteira de Cobrança (PORTA)	PT_COD	Pode ter restrição por cliente.
Local de Estoque (LOCEST)	LE_COD	Precisa estar ativo.
Centro de Custo (SETOR)	ST_COD	Validado na inclusão.
Vendedor / Representante (VEND)	VD_COD	Precisa estar ativo. Pode haver controle de carteira de clientes.
Transportadora (TRANS)	TR_COD	Obrigatória; use o código da transportadora padrão quando não houver frete.

Esses cadastros são mantidos pela operação dentro do próprio ERP. Para conhecer os objetos exatos e as chaves de referência aceitas, consulte o dicionário oficial da sua instância.

O código do pedido (PE_COD) compõe a chave primária de PED1 junto com FL_COD (empresa) e CF_TIPO, e deve ser informado pelo integrador na criação. O ERP não gera esse código em uma sequence dedicada — a regra é: o próximo código livre é o maior PE_COD existente, para a mesma empresa e tipo, mais 1.

próximo PE_COD = MAX(PE_COD em PED1 onde FL_COD = empresa e CF_TIPO = 'C') + 1

Recupere esse máximo com uma consulta prévia (method: GET) sobre PED1. A forma exata de pedir o agregado está no dicionário oficial, na entrada do objeto PED1.

Com o PE_COD livre obtido, inclua o cabeçalho por uma requisição com "method": "POST" sobre a tabela PED1.

Campos obrigatórios (não preenchidos automaticamente)

Os campos abaixo são NOT NULL e não têm preenchimento automático — precisam vir no corpo da requisição:

Campo	Descrição
FL_COD	Código da empresa/filial.
CF_TIPO	Fixo "C" para pedido de venda.
PE_COD	Código do pedido obtido no Passo 2.
CF_COD	Código do cliente (pessoa).
TM_COD	Tipo de movimento (saída/venda). Campo central: dirige documento, estoque, preço e tributação.
VD_COD	Vendedor / representante.
PZ_COD	Condição de pagamento.
FP_COD	Forma de pagamento.
PT_COD	Carteira de cobrança.
LE_COD	Local de estoque.
ST_COD	Centro de custo.
TR_COD	Transportadora.
PE_DAT	Data de emissão do pedido.

Campos preenchidos automaticamente pelo servidor

Não é necessário enviar os campos abaixo; o servidor os resolve na inclusão:

• PE_ID — sequencial único (maior + 1).
• PE_STATUS — um pedido nunca é incluído fechado; na inclusão o valor é forçado para 0 (aberto), mesmo que você envie outro valor.
• CF_COD2 e CF_COD3 — quando nulos, recebem o próprio CF_COD.
• PE_CTRLESTOQUE e PE_USAPRECOCHEIO — derivados do tipo de movimento (TM_COD).
• PE_USERCTRL, PE_DATPRO, PE_STATUSDATA — usuário e datas de controle.
• TBP_COD (tabela de preço), PE_OBS (observação padrão do cliente) e PE_CLAUSULA — quando não informados.

Exemplo — POST PED1 (cabeçalho do pedido)

{
    "method": "POST",
    "objectType": "TABLE",
    "objectName": "PED1",
    "dataFields": [
        { "name": "FL_COD",    "value": 1 },
        { "name": "CF_TIPO",   "value": "C" },
        { "name": "PE_COD",    "value": 99 },
        { "name": "CF_COD",    "value": 150 },
        { "name": "TM_COD",    "value": "S001" },
        { "name": "VD_COD",    "value": 26 },
        { "name": "PZ_COD",    "value": 30 },
        { "name": "FP_COD",    "value": 1001 },
        { "name": "PT_COD",    "value": 1001 },
        { "name": "LE_COD",    "value": 1 },
        { "name": "ST_COD",    "value": 5 },
        { "name": "TR_COD",    "value": 1 },
        { "name": "PE_DAT",    "value": "2026-07-18" },
        { "name": "PE_STATUS", "value": 0 }
    ]
}

Valores ilustrativos. Os códigos acima são exemplos. Use os cadastros da sua instância. A lista completa e autoritativa de campos de PED1 está no dicionário oficial.

Com o cabeçalho criado, inclua um POST em PED2 para cada produto. A chave do item é (FL_COD, CF_TIPO, PE_COD, PE_ITM, PD_COD), e deve apontar para o cabeçalho recém-criado.

Campos que você informa

Campo	Descrição
FL_COD, CF_TIPO, PE_COD	Iguais aos do cabeçalho (CF_TIPO = "C").
PD_COD	Código do produto.
PE_QTDCONV	Quantidade na unidade operacional (a "quantidade" que o usuário digitaria).
PE_UNICONV	Unidade dessa quantidade. Se omitida, assume a unidade de venda do produto.
PE_PRCCONVCHEIO	Preço unitário "cheio" na unidade informada. Opcional: se omitido, o sistema sugere o preço da tabela de preços.

Campos preenchidos automaticamente pelo servidor

• PE_ITM — número do item; auto-incrementado (maior item do pedido + 1) quando enviado como 0 ou omitido.
• TM_COD2 — tipo de movimento do item; herda o TM_COD do cabeçalho quando não informado.
• PD_CODNCM — NCM do produto (erro se o produto não tiver NCM).
• PE_PRCSUG, PE_PRCBASE, TBP_COD, FAT_COD — preço sugerido/base e fator, buscados na tabela de preços.
• Unidades e quantidades derivadas: PE_UNI, PE_UNIEST, PE_FATOR, PE_FATCONV, PE_QTD, PE_QTDEST, PE_PRC, PE_SALQTD.

Exemplo — POST PED2 (um item)

{
    "method": "POST",
    "objectType": "TABLE",
    "objectName": "PED2",
    "dataFields": [
        { "name": "FL_COD",          "value": 1 },
        { "name": "CF_TIPO",         "value": "C" },
        { "name": "PE_COD",          "value": 99 },
        { "name": "PD_COD",          "value": 120 },
        { "name": "PE_UNICONV",      "value": "KG" },
        { "name": "PE_QTDCONV",      "value": "1000" },
        { "name": "PE_PRCCONVCHEIO", "value": "100.00" }
    ]
}

Repita a requisição, alterando PD_COD/quantidade/preço, para cada produto do pedido. Cada inclusão marca o pedido como pendente de cálculo (o total só é apurado no Passo 5).

Após inserir todos os itens, execute a procedure PRC_CALCULAPEDIDO por uma requisição com "method": "PATCH". É esse cálculo que consolida o pedido: apura os impostos e valores de cada item, totaliza o cabeçalho (tabela PEDT) e gera o financeiro.

Parâmetros

Parâmetro	Descrição
VFL_COD	Código da empresa (igual ao FL_COD do pedido).
VCF_TIPO	"C" para pedido de venda.
VPE_COD	Código do pedido (PE_COD).
VOP	Opcional. 0 (padrão) = calcula itens e totais; 1 = calcula somente os totais.

Exemplo — PATCH PRC_CALCULAPEDIDO

{
    "method": "PATCH",
    "objectType": "PROCEDURE",
    "objectName": "PRC_CALCULAPEDIDO",
    "params": [
        { "name": "VFL_COD",  "value": 1 },
        { "name": "VCF_TIPO", "value": "C" },
        { "name": "VPE_COD",  "value": 99 }
    ]
}

Ao final, a procedure marca o pedido como calculado (PEDT.PE_TOT_CALCULADO = 1) e dispara a geração/verificação do financeiro.

Com o pedido calculado e conferido, feche o cabeçalho por uma requisição com "method": "PUT" sobre PED1, alterando PE_STATUS de 0 para 1 (cadeado fechado / concluído).

O que o fechamento dispara (tipo C)

A transição de PE_STATUS 0 → 1 aciona, no servidor, uma sequência de validações e rotinas:

• Permissão de cadeado — o usuário do userToken precisa do acesso SpaComFecharCadeadoPedido1.
• Recálculo automático — se o pedido estiver pendente (PE_TOT_CALCULADO = 0), o servidor chama PRC_CALCULAPEDIDO.
• Validação de crédito do cliente — limites e situação cadastral.
• Faturamento mínimo — se a condição de pagamento exigir valor mínimo, o total líquido é conferido.
• Liberação do pedido — regras de liberação comercial são executadas.

Exemplo — PUT PED1 (fechar o pedido)

{
    "method": "PUT",
    "objectType": "TABLE",
    "objectName": "PED1",
    "dataFields": [
        { "name": "PE_STATUS", "value": 1 }
    ],
    "where": [
        { "type": "field", "name": "FL_COD",  "key": true, "value": 1 },
        { "type": "field", "name": "CF_TIPO", "key": true, "value": "C" },
        { "type": "field", "name": "PE_COD",  "key": true, "value": 99 }
    ]
}

Use requisições com "method": "GET" para conferir o resultado. O verbo de leitura é geralmente liberado mesmo quando os verbos de escrita são restritos.

• Totais do pedido — consulte a tabela PEDT (por FL_COD, CF_TIPO, PE_COD) para ver total bruto, líquido, impostos e o indicador PE_TOT_CALCULADO.
• Cabeçalho — GET em PED1 confirma PE_STATUS e demais campos resolvidos pelo servidor.
• Itens — GET em PED2 filtrado pelo PE_COD mostra as quantidades, unidades e valores calculados.
• Próximo código (Passo 2) — recuperar o maior PE_COD atual antes de uma nova inclusão.

Os parâmetros aceitos na consulta (fields, where, orderBy, limit, offset) e a estrutura de retorno estão descritos no dicionário oficial.