Orçamento de Importação — Guia de Integração via API

Antes do primeiro orçamento, os cadastros abaixo precisam existir e estar configurados no ERP. É deles que o servidor tira as despesas, os tributos, as datas e as parcelas do câmbio:

Cadastro	Por que importa
Modelo de Processo de Importação (CEIPROCESMODELO)	Tem o tipo de movimento de nacionalização (TM_CODNAC), o de saída (TM_CODSAI) e as indicações de formação de preço (MDL_PRECO*), nove delas copiadas para o orçamento. É a origem dos valores que você copia no Passo 3. O TM_CODSAI do orçamento vem do modelo, no servidor.
Receitas e despesas previstas do modelo (CEIPROCESMODELO6)	As despesas com impacto no custo (MDL_IMPCUSTO) de 1 a 4 nascem no orçamento na inclusão do cabeçalho; as demais, no cálculo. A pessoa (CF_COD) e a condição de pagamento (PZ_COD) de cada despesa definem a previsão financeira e a data prevista.
Tipo de movimento de entrada (TMOV)	Define o tipo de importação (TM_TIPOIMPORTA) e a incidência do PIS/Cofins na base do ICMS (TM_PISCOFINSICMS). Com rateio por peso (valor 1) do frete (TM_IMPRAT_FRETE), do seguro (TM_IMPRAT_SEGURO), das despesas de entrada (TM_IMPRAT_DESPENT) ou dos acréscimos, deduções e variação cambial (TM_IMPRAT_ADVC), o cálculo exige peso bruto em cada item.
Tipos de despesa (CEIPROCESTPDOC) e o tipo de documento de cada um, com a data-base (TPDOC.TD_CODDATABASE)	O cálculo define a data de previsão de cada despesa do modelo pela data-base do tipo de documento, somada ao prazo da condição de pagamento da despesa no modelo. No orçamento valem quatro data-bases, cada uma ligada a uma data do cabeçalho: 102 Previsão do Embarque (OCI_PREVISAOEMBARQUE), 104 Previsão de Chegada (OCI_PREVISAOCHEGADA), 106 Previsão de Entrega (OCI_DATAPREVENTREGA) e 108 Cadastro do Processo (OCI_DATCAD). Configure a data-base nos tipos de documento das despesas do modelo; sem ela, e com CG_FT_USAPREVIAFIN = 1, a geração do processo é recusada por falta de prazo (ver Validações e erros).
Produto (PROD, PRODNCM)	A NCM (PD_CODNCM) do item precisa ser a do cadastro, quando o produto não é genérico. O peso do cadastro (do produto ou da equivalência da unidade) entra no item que vier sem peso. O percentual de I.I. (PD_PERCII do produto ou, na falta dele, da NCM) decide em qual adição o item cai.
Moeda (INDICES) e condição de pagamento com parcelas (PRAZO)	Quando o modelo prevê a despesa de Contrato de Câmbio (tipo 100), a condição de pagamento do orçamento (PZ_COD) a divide em uma despesa por parcela.
Status de processo (CEISTATUSPROCESSO)	Pelo menos um status de cada tipo: 1 Ativo, 2 Encerrado e 3 Cancelado. O processo gerado no Passo 11 nasce com o status de tipo Ativo de menor código.
Pessoas (CLIFOR1)	O cliente do orçamento, o fornecedor e o fabricante de cada adição e as pessoas das despesas. Com CG_PIM_SUGESTAOCODIGO = 2, o cliente precisa da sigla de processo (CF_PREFIXOPROCESSO). Ver Cadastro de Pessoas.
Configuração da instância	CG_FT_USAPREVIAFIN e CG_PIM_SUGESTAOCODIGO — ver a seção 6 e a configuração da instância na página central.

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

Na tela, escolher o modelo e o produto preenche vários campos do orçamento. Pela API, esse preenchimento é seu: leia os valores com "method": "GET" e copie-os nos Passos 3 e 4.

O que ler e para onde vai

Leia	Onde	Envie em
TM_CODNAC	CEIPROCESMODELO, por MDL_COD	CEIORC1.TM_CODENT
TM_TIPOIMPORTA do tipo de movimento TM_CODNAC	TMOV, por TM_COD	CEIORC1.OCI_TIPOIMPORTA
MDL_PRECOCIF, MDL_PRECOII, MDL_PRECOIPI, MDL_PRECOPISCOFINS, MDL_PRECOANTIDUMPING, MDL_PRECOICMSNACIO, MDL_PRECOAFRMM, MDL_PRECODESPESAENTRADA, MDL_PRECODESPESASAIDA	CEIPROCESMODELO	As nove OCI_PRECO* de mesmo sufixo, uma a uma (ver o Passo 3)
As despesas previstas	CEIPROCESMODELO6, por MDL_COD	Referência para o Passo 6: são elas que vão nascer no orçamento
PD_CODNCM, PD_UNI3, PD_DES, PD_GENERICO	PROD, por PD_COD	CEIORC2.PD_CODNCM, OCI_UNI e OCI_DESCRICAO (ver o Passo 4)

O modelo também tem condição de pagamento (PZ_COD) e responsável (VD_COD). A tela não os copia para o orçamento; se a sua operação usa os do modelo, copie-os você.

Exemplo — GET CEIPROCESMODELO

{
    "method": "GET"
    ,"objectType": "TABLE"
    ,"objectName": "CEIPROCESMODELO"
    ,"fields": [
        "TM_CODNAC"
        ,"TM_CODSAI"
        ,"PZ_COD"
        ,"VD_COD"
        ,"MDL_PRECOCIF"
        ,"MDL_PRECOII"
        ,"MDL_PRECOIPI"
        ,"MDL_PRECOPISCOFINS"
        ,"MDL_PRECOANTIDUMPING"
        ,"MDL_PRECOICMSNACIO"
        ,"MDL_PRECOAFRMM"
        ,"MDL_PRECODESPESAENTRADA"
        ,"MDL_PRECODESPESASAIDA"
    ]
    ,"where": [
        { "type": "field", "name": "MDL_COD", "value": 3 }
    ]
}

Com o TM_CODNAC devolvido, leia o tipo de importação:

{
    "method": "GET"
    ,"objectType": "TABLE"
    ,"objectName": "TMOV"
    ,"fields": [
        "TM_TIPOIMPORTA"
    ]
    ,"where": [
        // TM_CODNAC lido no modelo
        { "type": "field", "name": "TM_COD", "value": "E060" }
    ]
}

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

Inclua o cabeçalho por uma requisição com "method": "POST" sobre CEIORC1.

Envie

Campo	Observação
OCI_COD = 0	Obrigatório e sempre presente. O servidor gera o código do orçamento e o devolve na resposta.
CF_COD	Obrigatório. Cliente do orçamento.
MDL_COD	Obrigatório. Modelo de processo lido no Passo 2.
ID_COD e OCI_IDCOTACAO	Moeda e cotação do orçamento. Exigidas pelo cálculo.
OCI_INCOTERM	Exigido pelo cálculo. Domínio: CFR, CPT, CIF, CIP, FOB, FCA, EXW.
OCI_CODINTERNO	Código de controle da empresa. Exigido para gerar o processo; não pode repetir o código interno de outro processo.
PZ_COD	Condição de pagamento do câmbio. Envie já na inclusão: as parcelas do câmbio saem dela.
OCI_PREVISAOEMBARQUE, OCI_PREVISAOCHEGADA, OCI_DATAPREVENTREGA	Opcionais, com T. São data-bases das despesas (Passo 1) e seguem para o processo. Envie as que os tipos de documento das despesas do modelo usam.
VD_COD, OCI_CODCLISAI	Opcionais. Responsável e cliente da nota de saída.

A tela preenche, a API não — envie você

Campo	O que a tela grava
FL_COD	Obrigatório. A empresa em que o usuário está logado.
TM_CODENT	Obrigatório. O TM_CODNAC do modelo.
OCI_DATCAD	A data do dia, com T. É a data-base 108 e o ponto de partida do prazo das previsões financeiras. Pela API, fica vazia se não for enviada.
OCI_TIPOIMPORTA	O TM_TIPOIMPORTA do tipo de movimento TM_CODNAC. Domínio: 1 Conta e Ordem, 2 Encomenda, 3 Distribuição.
OCI_PRECOCIF, OCI_PRECOII, OCI_PRECOIPI, OCI_PRECOPISCOFINS, OCI_PRECOANTIDUMPING, OCI_PRECOICMSNACIO, OCI_PRECOAFRMM, OCI_PRECODESPESAENTRADA, OCI_PRECODESPESASAIDA	As indicações de formação de preço do modelo (0 não, 1 sim). Copie cada MDL_PRECO* para a OCI_PRECO* de mesmo sufixo — por exemplo, MDL_PRECOICMSNACIO para OCI_PRECOICMSNACIO e MDL_PRECOANTIDUMPING para OCI_PRECOANTIDUMPING. Sem elas, o preço base de saída do item (OCI_PRECOBASEITEM) sai zero.
OCS_COD	Opcional. O primeiro status comercial cadastrado. Se a sua operação usa status comercial, combine o código com o gestor do ERP.

Não envie

Campo	Por quê
TM_CODSAI, OCI_PISCOFINSICMS	O servidor preenche na inclusão: o primeiro a partir do modelo, o segundo a partir do tipo de movimento de entrada. O valor enviado é substituído.
OCI_PBCARGA, OCI_PLCARGA	Peso bruto e líquido da carga: o cálculo grava a soma dos itens.
PIM_COD, DIM_COD	Vínculos com o processo e com a declaração de importação. O PIM_COD é gravado pela geração do processo (Passo 11).

Exemplo — POST CEIORC1

{
    "method": "POST"
    ,"objectType": "TABLE"
    ,"objectName": "CEIORC1"
    ,"dataFields": [
        // numerado pelo servidor: sempre presente, com 0
        { "name": "OCI_COD",                 "value": 0 }
        ,{ "name": "FL_COD",                  "value": 1 }
        ,{ "name": "CF_COD",                  "value": 2150 }
        ,{ "name": "MDL_COD",                 "value": 3 }
        // TM_CODNAC do modelo
        ,{ "name": "TM_CODENT",               "value": "E060" }
        ,{ "name": "ID_COD",                  "value": 2 }
        ,{ "name": "OCI_IDCOTACAO",           "value": 5.4321 }
        ,{ "name": "OCI_INCOTERM",            "value": "FOB" }
        ,{ "name": "OCI_CODINTERNO",          "value": "IMP-2026-015" }
        ,{ "name": "PZ_COD",                  "value": 12 }
        ,{ "name": "OCI_DATCAD",              "value": "2026-09-28T00:00:00" }
        ,{ "name": "OCI_PREVISAOEMBARQUE",    "value": "2026-10-15T00:00:00" }
        ,{ "name": "OCI_PREVISAOCHEGADA",     "value": "2026-11-10T00:00:00" }
        // TM_TIPOIMPORTA do tipo de movimento TM_CODNAC
        ,{ "name": "OCI_TIPOIMPORTA",         "value": 3 }
        // as nove indicações de preço, copiadas uma a uma do modelo
        ,{ "name": "OCI_PRECOCIF",            "value": 1 }
        ,{ "name": "OCI_PRECOII",             "value": 1 }
        ,{ "name": "OCI_PRECOIPI",            "value": 0 }
        ,{ "name": "OCI_PRECOPISCOFINS",      "value": 1 }
        ,{ "name": "OCI_PRECOANTIDUMPING",    "value": 0 }
        ,{ "name": "OCI_PRECOICMSNACIO",      "value": 1 }
        ,{ "name": "OCI_PRECOAFRMM",          "value": 1 }
        ,{ "name": "OCI_PRECODESPESAENTRADA", "value": 1 }
        ,{ "name": "OCI_PRECODESPESASAIDA",   "value": 0 }
    ]
}

A resposta traz Registro inserido com sucesso e, em data, o OCI_COD gerado. Guarde-o: é a chave de todos os passos seguintes. Confira por GET em CEIORC1 os campos que o servidor preencheu (TM_CODSAI e OCI_PISCOFINSICMS).

Faça um POST em CEIORC2 para cada produto, apontando para o OCI_COD do Passo 3. Inclua todos os itens antes de completar as adições e de calcular.

Envie

Campo	Observação
OCI_COD	Código do orçamento, devolvido no Passo 3.
OCI_ITM = 0	Obrigatório e sempre presente. O servidor numera o item dentro do orçamento.
PD_COD	Obrigatório. Código do produto.
OCI_QTD	Exigida pelo cálculo. Quantidade. Sem ela, o FOB do item sai zero.
OCI_PRECOMNEG	Exigido pelo cálculo. Preço unitário na moeda negociada. Sem ele, o FOB do item sai zero.
OCI_PESO, OCI_PESOL	Opcionais. Peso bruto e líquido totais do item (não unitários). Vazios ou zero, o cálculo usa o peso do cadastro vezes a quantidade.
OCI_PDESCONTOMNEG ou OCI_VDESCONTOMNEG	Opcionais. Percentual ou valor do desconto na moeda negociada. Basta um: o cálculo deriva o outro.

A tela preenche, a API não — envie você

Campo	O que a tela grava
PD_CODNCM	Obrigatório. A NCM do produto (PROD.PD_CODNCM). Para produto não genérico (PD_GENERICO = 0), precisa ser igual à do cadastro.
OCI_UNI	A unidade de controle do produto (PROD.PD_UNI3). Precisa existir em PRODUNI.
OCI_DESCRICAO	A descrição do produto (PROD.PD_DES), que pode ser detalhada depois.

Não envie

Campo	Por quê
OCI_ADICAO	Omita. O servidor procura no orçamento uma adição com a mesma NCM e o mesmo percentual de I.I. do item; se não encontrar, cria uma adição nova, ainda sem fornecedor, que você completa no Passo 5.
FOB, frete, seguro, CIF, bases e valores de tributo, OCI_TOTALITEM, OCI_VLRCUSTOITEM, OCI_PRECOBASEITEM, OCI_VLRCUSTOGERITEM	Calculados pelo servidor no Passo 7.

Exemplo — POST CEIORC2 (um item)

{
    "method": "POST"
    ,"objectType": "TABLE"
    ,"objectName": "CEIORC2"
    ,"dataFields": [
        { "name": "OCI_COD",       "value": 1024 }
        // numerado pelo servidor: sempre presente, com 0
        ,{ "name": "OCI_ITM",       "value": 0 }
        ,{ "name": "PD_COD",        "value": 4521 }
        // lidos em PROD: PD_CODNCM, PD_UNI3 e PD_DES
        ,{ "name": "PD_CODNCM",     "value": "84713012" }
        ,{ "name": "OCI_UNI",       "value": "UN" }
        ,{ "name": "OCI_DESCRICAO", "value": "Notebook 14 polegadas" }
        ,{ "name": "OCI_QTD",       "value": 200 }
        ,{ "name": "OCI_PRECOMNEG", "value": 85.50 }
        // peso bruto total do item; omita para usar o do cadastro
        ,{ "name": "OCI_PESO",      "value": 420.000 }
    ]
}

Repita para cada produto. Depois de incluir os itens, leia as adições (Passo 5) para saber quais foram criadas.

Exemplo — POST CEIORC3 (adição criada antes do item)

{
    "method": "POST"
    ,"objectType": "TABLE"
    ,"objectName": "CEIORC3"
    ,"dataFields": [
        { "name": "OCI_COD",    "value": 1024 }
        // numerado pelo servidor: sempre presente, com 0
        ,{ "name": "OCI_ADICAO", "value": 0 }
        ,{ "name": "PD_CODNCM",  "value": "84713012" }
        ,{ "name": "CF_CODFOR",  "value": 3310 }
    ]
}

Leia as adições do orçamento com GET em CEIORC3, filtrando por OCI_COD, e grave o fornecedor em cada uma com um PUT. O cálculo recusa o orçamento enquanto alguma adição estiver sem fornecedor.

Envie

Campo	Observação
OCI_COD e OCI_ADICAO, no where	Os dois com "key": true. Um where só com OCI_COD altera todas as adições do orçamento.
CF_CODFOR	Fornecedor da adição. Exigido pelo cálculo em todas as adições, inclusive nas que tenham ficado sem item.
CF_CODFAB	Opcional. Fabricante.

A tela preenche, a API não — envie você

Nenhum campo: na adição, a tela também espera que o usuário informe o fornecedor e o fabricante.

Não envie

Campo	Por quê
OCI_IPICMS, OCI_IPICMST	O servidor recalcula em toda gravação da adição, a partir do fornecedor e do tipo de movimento de entrada.
OCI_PERII, OCI_PERIPI, OCI_PERPIS, OCI_PERCOFINS, OCI_PICM, OCI_REDICM, OCI_PBCR, OCI_PICMST, OCI_PCTREDPIS, OCI_PCTREDCOFINS	Percentuais de tributo: o cálculo os regrava.
A chave em dataFields	OCI_COD e OCI_ADICAO vão só no where.

Exemplo — PUT CEIORC3 (uma adição)

{
    "method": "PUT"
    ,"objectType": "TABLE"
    ,"objectName": "CEIORC3"
    ,"dataFields": [
        { "name": "CF_CODFOR", "value": 3310 }
        ,{ "name": "CF_CODFAB", "value": 3311 }
    ]
    ,"where": [
        { "type": "field", "name": "OCI_COD",    "key": true, "value": 1024 }
        ,{ "type": "field", "name": "OCI_ADICAO", "key": true, "value": 1 }
    ]
}

Leia as despesas com GET em CEIORC4, filtrando por OCI_COD: as do modelo com impacto no custo de 1 a 4 já estão lá desde o Passo 3. Ajuste as existentes com PUT e use POST só para despesa avulsa, que o modelo não prevê. As demais despesas do modelo entram no cálculo (Passo 7).

Envie

Campo	Observação
OCI_COD e OCI_ITM, no where do PUT	Os dois com "key": true. Um where só com OCI_COD altera todas as despesas.
OCI_ITM = 0 e TDP_COD, no POST	Obrigatórios na despesa avulsa. O servidor numera o OCI_ITM.
O valor: OCI_VALORMNAC, ou OCI_VALORMNEG com ID_COD e OCI_IDCOTACAO	Valor em moeda nacional, ou valor em moeda negociada com a moeda e a cotação. Nos tipos de despesa de importação (TDP_TIPODESPIMP de 100 a 199, ver CEI_VIEW_TIPODOCUMENTO), o cálculo converte o valor negociado para a moeda nacional, e cotação sem valor negociado é recusada. Nos demais tipos, envie também OCI_VALORMNAC: é ele que entra no custo e na previsão financeira.
CF_COD	Pessoa da despesa. Só a despesa com pessoa vira previsão financeira do processo.
OCI_IMPCUSTO, OCI_REEMBOLSO, OCI_INCIDEICMS	Impacto no custo, conta corrente e incidência na base do ICMS. Nas despesas do modelo, já vêm do modelo. Domínios no dicionário oficial.
OCI_DATAPREV	Data de previsão, com T. Envie na despesa avulsa; na despesa do modelo, a data vem da data-base (Passo 1).

A tela preenche, a API não — envie você

Nenhum campo: a tela e a API gravam as despesas do mesmo jeito, e as despesas do modelo são criadas pelo servidor nos dois casos.

Não envie

Campo	Por quê
Um POST de tipo de despesa que já está no orçamento	Para mudar uma despesa que já está no orçamento, use PUT: um POST do mesmo tipo inclui uma segunda despesa.
Valor e cotação das despesas calculadas pelo sistema	O cálculo grava: tributos de nacionalização (tipos de despesa de importação 103 a 106 e 128 a 130), câmbio (100, quando o orçamento tem condição de pagamento) e despesas de saída calculadas (200 a 205, 211 a 218 e 221). O tipo de cada despesa está em CEIPROCESTPDOC.TDP_TIPODESPIMP, e a lista dos tipos, em CEI_VIEW_TIPODOCUMENTO.
OCI_DATAPREV das despesas do modelo	O cálculo define a data pela data-base do tipo de documento.
A chave em dataFields do PUT	OCI_COD e OCI_ITM vão só no where.

Exemplo — PUT CEIORC4 (despesa do modelo)

{
    "method": "PUT"
    ,"objectType": "TABLE"
    ,"objectName": "CEIORC4"
    ,"dataFields": [
        { "name": "OCI_VALORMNAC", "value": 1850.00 }
        ,{ "name": "CF_COD",        "value": 3400 }
    ]
    ,"where": [
        { "type": "field", "name": "OCI_COD", "key": true, "value": 1024 }
        ,{ "type": "field", "name": "OCI_ITM", "key": true, "value": 2 }
    ]
}

Exemplo — POST CEIORC4 (despesa avulsa em moeda negociada)

{
    "method": "POST"
    ,"objectType": "TABLE"
    ,"objectName": "CEIORC4"
    ,"dataFields": [
        { "name": "OCI_COD",       "value": 1024 }
        // numerado pelo servidor: sempre presente, com 0
        ,{ "name": "OCI_ITM",       "value": 0 }
        ,{ "name": "TDP_COD",       "value": 45 }
        ,{ "name": "OCI_VALORMNEG", "value": 300.00 }
        ,{ "name": "ID_COD",        "value": 2 }
        ,{ "name": "OCI_IDCOTACAO", "value": 5.4321 }
        // 300.00 x 5.4321: informe quando o tipo não é de importação (100 a 199)
        ,{ "name": "OCI_VALORMNAC", "value": 1629.63 }
        ,{ "name": "OCI_IMPCUSTO",  "value": 1 }
        ,{ "name": "CF_COD",        "value": 3400 }
        ,{ "name": "OCI_DATAPREV",  "value": "2026-11-20T00:00:00" }
    ]
}

Com itens, adições e despesas completos, execute a rotina CEI_PRC_CALCULAORCAMENTO por uma requisição com "method": "PATCH". Calcule depois de qualquer alteração e antes de gerar o processo.

Envie

Parâmetro	Descrição
VOCI_COD	Código do orçamento a calcular (CEIORC1.OCI_COD).

A tela faz, a API não — faça você

Depois de calcular, a tela relê o orçamento na hora. Pela API, a rotina não devolve valores: leia o resultado no Passo 8.

O que o cálculo grava

• Nos itens: FOB nas duas moedas, desconto, pesos, frete, seguro, tributos (II, IPI, PIS, Cofins, ICMS, ICMS-ST, antidumping e AFRMM), custo e preço base de saída.
• Nas adições: os percentuais de tributo.
• No cabeçalho: o peso bruto e o líquido da carga.
• Nas despesas: as despesas do modelo que faltavam, os valores das despesas calculadas pelo sistema e as datas de previsão das despesas do modelo.
• Os Orçamentos para Cliente vinculados ao orçamento, que são recalculados junto.

Exemplo — PATCH CEI_PRC_CALCULAORCAMENTO

{
    "method": "PATCH"
    ,"objectType": "PROCEDURE"
    ,"objectName": "CEI_PRC_CALCULAORCAMENTO"
    ,"params": [
        { "name": "VOCI_COD", "value": "1024" }
    ]
}

Leia o resultado do cálculo com "method": "GET":

Objeto	Filtro	O que traz
CEI_VIEW_ORCTOTALORCAMENTO	OCI_COD	Totais do orçamento: FOB, frete, seguro, CIF, bases e valores de tributo, peso e custo (OCI_TOT_*).
CEI_VIEW_ORCTOTALADICAO	OCI_COD e OCI_ADICAO	Os mesmos totais por adição. Adição sem item não aparece.
CEIORC2	OCI_COD	Valores calculados de cada item.
CEIORC4	OCI_COD	Despesas com valores e datas de previsão.

Exemplo — GET CEI_VIEW_ORCTOTALORCAMENTO

{
    "method": "GET"
    ,"objectType": "VIEW"
    ,"objectName": "CEI_VIEW_ORCTOTALORCAMENTO"
    ,"fields": [
        "OCI_TOT_VALORFOBMNEG"
        ,"OCI_TOT_VALORFOBMNAC"
        ,"OCI_TOT_TOTALCIF"
        ,"OCI_TOT_VII"
        ,"OCI_TOT_VIPI"
        ,"OCI_TOT_VICMS"
        ,"OCI_TOT_VLRCUSTOITEM"
    ]
    ,"where": [
        { "type": "field", "name": "OCI_COD", "value": 1024 }
    ]
}

Altere com "method": "PUT" na tabela do dado e calcule de novo (Passo 7): nada é recalculado sozinho, e a geração do processo parte do que estiver gravado no orçamento.

Envie

Situação	O que enviar
Quantidade, preço, peso ou desconto do item	PUT em CEIORC2 com os campos alterados.
Item novo	POST em CEIORC2 (Passo 4). Depois, leia as adições e informe o fornecedor em qualquer adição nova (Passo 5).
Cotação, moeda ou INCOTERM	PUT em CEIORC1.
Troca de tipo de movimento de entrada	TM_CODENT e, junto, OCI_PISCOFINSICMS (o TM_PISCOFINSICMS do tipo novo): o servidor só deriva esse campo na inclusão.

A tela preenche, a API não — envie você

Situação

O que a tela grava

Troca de modelo (MDL_COD)

A tela copia de novo o TM_CODENT, o OCI_TIPOIMPORTA e as nove OCI_PRECO* do modelo novo. Pela API, o servidor atualiza só o TM_CODSAI: envie os demais no mesmo PUT, lidos como no Passo 2, incluindo o OCI_PISCOFINSICMS (o TM_PISCOFINSICMS do novo TM_CODENT, lido em TMOV). As despesas do modelo novo com impacto no custo de 1 a 4 são criadas só na inclusão do cabeçalho: inclua-as por POST (Passo 6) e exclua as do modelo anterior que não se aplicam. As demais entram no próximo cálculo.

Não envie

Campo	Por quê
A chave em dataFields	Ela vai só no where.
TM_CODSAI	O servidor o regrava a partir do modelo quando o MDL_COD muda.
Campos calculados	Os listados como "não envie" nos Passos 4 a 6: o próximo cálculo os regrava.

Exemplo — PUT CEIORC2 (quantidade de um item)

{
    "method": "PUT"
    ,"objectType": "TABLE"
    ,"objectName": "CEIORC2"
    ,"dataFields": [
        { "name": "OCI_QTD", "value": 250 }
    ]
    ,"where": [
        { "type": "field", "name": "OCI_COD", "key": true, "value": 1024 }
        ,{ "type": "field", "name": "OCI_ITM", "key": true, "value": 1 }
    ]
}

Exclua com "method": "DELETE", das tabelas filhas para o cabeçalho. Exclua antes de gerar o processo (Passo 11).

Excluir	Como	Efeito e o que impede
Item	CEIORC2, por OCI_COD e OCI_ITM	O vínculo do item com o Orçamento para Cliente e com a Ordem de Compra é excluído junto. A adição fica: se ficou vazia, exclua-a ou informe nela o fornecedor, senão o próximo cálculo é recusado.
Adição	CEIORC3, por OCI_COD e OCI_ADICAO	Recusada enquanto houver item nela: exclua os itens antes.
Despesa	CEIORC4, por OCI_COD e OCI_ITM	Sem restrição. Uma despesa do modelo com impacto no custo diferente de 1 a 4 volta no próximo cálculo.
Orçamento inteiro	Nesta ordem, cada DELETE com where só por OCI_COD: CEIORC4 → CEIORC2 → CEIORC3 → CEIORCVAR → anexos → CEIORC1	Numa tabela sem linhas, a resposta é O registro informado para DELETE nao existe: siga para a próxima. Remova os anexos pelo endpoint de anexos (Controle de Anexos): descubra o id_recurso do Orçamento de Importação com acao=recursos; liste os anexos com acao=listar, esse id_recurso e id_registro no formato OCI_COD; (por exemplo, 1024;, com o ponto e vírgula); e exclua cada id_arquivo devolvido.

Exemplo — DELETE CEIORC2 (um item)

{
    "method": "DELETE"
    ,"objectType": "TABLE"
    ,"objectName": "CEIORC2"
    ,"where": [
        { "type": "field", "name": "OCI_COD", "key": true, "value": 1024 }
        ,{ "type": "field", "name": "OCI_ITM", "key": true, "value": 2 }
    ]
}

Exemplo — DELETE CEIORC4 (todas as despesas do orçamento)

{
    "method": "DELETE"
    ,"objectType": "TABLE"
    ,"objectName": "CEIORC4"
    ,"where": [
        // só OCI_COD: exclui todas as despesas do orçamento
        { "type": "field", "name": "OCI_COD", "key": true, "value": 1024 }
    ]
}

Com o orçamento calculado e conferido, gere o Processo de Importação executando CEI_PRC_GERAPROCESSORCAMENTO com "method": "PATCH". Faça todas as alterações e exclusões antes: depois de gerado, as mudanças no orçamento não chegam ao processo.

Envie

Parâmetro	Descrição
POCI_COD	Código do orçamento que dá origem ao processo (CEIORC1.OCI_COD).

A tela faz, a API não — faça você

Depois de gerar, a tela relê o código do processo no orçamento e abre o processo. Pela API, a rotina não devolve o código: leia-o no Passo 12.

Condições, nesta ordem

1. O orçamento ainda não foi vinculado a um processo.
2. Tem código interno (OCI_CODINTERNO).
3. Tem itens.
4. Foi calculado: a soma do FOB dos itens é diferente de zero.

O que a geração faz

• Cria o processo em CEIPROCESCAD, com a descrição Processo gerado do Orçamento N e os dados do orçamento: filial, cliente, código interno, modelo, tipos de movimento, responsável, embarque e destino, previsões de embarque, chegada e entrega, formação do preço e condição de pagamento do câmbio. Do modelo de processo vêm também as transportadoras, a tributação e os dados de saldo e de extrato. O processo nasce com o status de tipo Ativo de menor código cadastrado em CEISTATUSPROCESSO.
• Grava o código do processo em CEIORC1.PIM_COD.
• Com CG_FT_USAPREVIAFIN = 1, lança uma previsão financeira para cada despesa do orçamento que tenha pessoa (CF_COD), com o valor e a data de previsão gravados em CEIORC4. Com 0, registra em CEIPROCESPREVISAO as provisões das despesas do modelo de processo, com o valor previsto de cada tipo de despesa (seção 6).

Com CG_PIM_SUGESTAOCODIGO maior que zero, o código interno do processo é o que a configuração sugere, e não o OCI_CODINTERNO.

Exemplo — PATCH CEI_PRC_GERAPROCESSORCAMENTO

{
    "method": "PATCH"
    ,"objectType": "PROCEDURE"
    ,"objectName": "CEI_PRC_GERAPROCESSORCAMENTO"
    ,"params": [
        { "name": "POCI_COD", "value": "1024" }
    ]
}

Leia o processo com "method": "GET", nesta ordem:

Objeto	Filtro	O que conferir
CEIORC1	OCI_COD	PIM_COD: o código do processo gerado.
CEIPROCESCAD	PIM_COD	O processo: descrição, código interno (PIM_CODINTERNO), status (PIM_STATUS), modelo e datas.
CEIPROCESPREVISAO	PIM_COD	As provisões financeiras do processo, na instância com CG_FT_USAPREVIAFIN = 0.
DOCSPREVISAO	PIM_COD	As previsões financeiras do processo, na instância com CG_FT_USAPREVIAFIN = 1.

Exemplo — GET CEIORC1 (código do processo)

{
    "method": "GET"
    ,"objectType": "TABLE"
    ,"objectName": "CEIORC1"
    ,"fields": [
        "PIM_COD"
    ]
    ,"where": [
        { "type": "field", "name": "OCI_COD", "value": 1024 }
    ]
}

Para operar o processo gerado (status, datas, títulos e consultas), siga pela página do Processo de Importação.