1. Introdução
Esta é a página central do módulo COMEX Importação. Ela não ensina um fluxo específico: apresenta como o módulo se organiza na API, o que muda de instância para instância, e encaminha para as páginas que cobrem cada fluxo em detalhe.
Pela API, o módulo cobre hoje o Orçamento de Importação de ponta a ponta — criar o cabeçalho, os itens, as adições e as despesas, calcular, alterar e excluir — e o Processo de Importação: criação (do orçamento, de Ordens de Compra ou por gravação direta), alteração, status e as consultas de estoque, financeiro e fluxo de caixa. O cadastro do processo (CEIPROCESCAD) e o markup de importação (CEIPRODMARKUP) admitem gravação direta; o processo que nasce de um orçamento ou de Ordens de Compra, porém, é criado por rotina. O restante do módulo — declaração de importação, câmbio, follow-up e catálogo de produtos — está disponível para consulta.
Leia esta página antes das outras. Três coisas aqui valem para o módulo inteiro e não se repetem em cada página: a regra de fronteira, que decide o que se grava direto e o que passa por rotina; a configuração da instância, que faz o mesmo fluxo se comportar de forma diferente em cada base; e o encadeamento, que mostra em que ordem os fluxos se apoiam.
Esta documentação não substitui o dicionário oficial da sua instância, que é a fonte autoritativa de campos, tipos e domínios.
2. Como a API funciona
A API do Spalla utiliza um conceito diferente do REST tradicional. Todas as requisições são enviadas para um único endpoint, e a operação executada não é determinada pelo verbo HTTP, e sim pelo campo "method" dentro do corpo JSON.
| Item | Valor |
|---|---|
| Endpoint único | /root/integrador |
| Verbo HTTP | PATCH (padrão, obrigatório para gravação). POST/GET são alternativas apenas para leitura. |
| Autenticação | Header ou query param userToken. |
| Operação real | Campo "method" dentro do corpo JSON. |
O endereço, o header e o exemplo de requisição completo estão na Documentação da API. As páginas deste módulo mostram só o corpo JSON.
Os valores de "method" usados no módulo, por tipo de objeto:
| method (no corpo) | objectType | Para que serve no módulo | Exemplo de objeto |
|---|---|---|---|
GET |
TABLE |
Ler tabelas: o modelo de processo, o orçamento gravado, o processo gerado. | CEIPROCESMODELO |
POST |
TABLE |
Incluir o cabeçalho, os itens e as despesas do orçamento, e o processo por gravação direta. | CEIORC1, CEIPROCESCAD |
PUT |
TABLE |
Alterar o que foi gravado, como o fornecedor de cada adição ou o status do processo. | CEIORC3 |
DELETE |
TABLE |
Excluir itens, adições, despesas ou o orçamento inteiro. | CEIORC2 |
PATCH |
PROCEDURE |
Executar as rotinas de ação: calcular o orçamento e gerar o processo a partir dele. | CEI_PRC_CALCULAORCAMENTO |
GET |
PROCEDURE RESULT |
Executar rotinas que devolvem um resultado estruturado, como as consultas de câmbio e de follow-up e a geração do processo a partir de Ordens de Compra. O tipo diz como o retorno chega, e não que a rotina só lê: a geração a partir de Ordens de Compra é executada com GET e grava o orçamento e o processo. Antes de executar, confira no dicionário da sua instância a descrição da rotina. |
CEI_RES_GERAR_IMPORTACAO_OC |
GET |
VIEW |
Ler consultas prontas, como os totais do orçamento calculado e o saldo da mercadoria da declaração de importação. | CEI_VIEW_ORCTOTALORCAMENTO |
Não confunda os dois níveis. O verbo HTTP da requisição é sempre PATCH (para gravação); o que define a operação é o campo "method" do JSON. Uma inclusão em CEIORC1 é uma requisição HTTP PATCH cujo corpo contém "method": "POST". Cada tipo de objeto aceita só os valores de "method" da tabela acima: uma rotina PROCEDURE é executada com "method": "PATCH", nunca com POST, e uma PROCEDURE RESULT, com "method": "GET".
Convenções que valem para todo o módulo
- Auto-incremento vai presente, com
0. Nas tabelas do orçamento, a última coluna da chave é numerada pelo servidor:OCI_CODemCEIORC1,OCI_ITMemCEIORC2eCEIORC4,OCI_ADICAOemCEIORC3. No processo, é oPIM_CODemCEIPROCESCAD. Envie o campo emdataFieldscom o valor0: o servidor calcula o próximo número e o devolve na resposta, junto com a mensagemRegistro inserido com sucesso. Se o campo faltar, a inclusão é recusada comO campo Auto-Incremente "OCI_COD" não foi encontrado na lista de campos para persistência!(com o nome do campo que faltou). - Data sempre com a hora, e o separador depende de onde ela vai. Em
dataFieldsdePOSTePUT,"AAAA-MM-DDTHH:MM:SS", comT. Emwhere,havingeparams,"AAAA-MM-DD HH:MM:SS", com espaço. A regra completa está em Datas, Horas e Data/Hora. - Valor numérico com ponto decimal, sem separador de milhar e sem símbolo de moeda.
- No
PUT, owhereleva a chave primária completa, e só ela, com"key": trueem cada coluna.CEIORC2,CEIORC3eCEIORC4têm chave composta (OCI_CODmaisOCI_ITMouOCI_ADICAO): com sóOCI_CODmarcado, a alteração alcança todas as linhas do orçamento naquela tabela. Os campos da chave não entram emdataFields. - No
DELETE, owhereé aplicado como veio. Para excluir uma linha, informe a chave completa. Umwheresó comOCI_CODexclui todas as linhas do orçamento naquela tabela — é assim que se exclui o orçamento inteiro, tabela por tabela, na ordem descrita no passo de exclusão do Orçamento de Importação. - Como chega o retorno de um
GET. Vale para tabelas, views e rotinasPROCEDURE RESULT:- Uma linha chega como objeto JSON; duas ou mais, como array. Trate os dois formatos.
- Consulta sem linhas não é falha. A resposta vem com HTTP
404e a mensagemNao foram encontrados resultados para a requisicao do tipo GET com os parametros informados [ rowCount:0 ].Trate como resultado vazio. - Erro chega precedido de
Falha ao tentar resolver a requisicao (GET). Erro:, com o texto sem acentos. Compare pelo trecho característico.
Os exemplos — alteração com a chave composta completa e inclusão com o auto-incremento em 0 — estão nos Passos 5 e 6 da página do Orçamento de Importação.
3. Onde encontrar o dicionário oficial da sua API
Esta documentação é complementar. A fonte da verdade sobre campos, parâmetros, tipos, domínios e exemplos é o dicionário da sua instância, gerado a partir do que o seu token alcança.
Cada empresa que opera o ERP Spalla expõe o seu próprio dicionário automático em um endereço próprio. Para acessá-lo, abra no navegador a URL no formato abaixo, substituindo os placeholders pelos valores da sua instância:
https://<host>:<porta>/root/dicionario?userToken=<token>
<host>— endereço do servidor que hospeda a API.<porta>— porta de comunicação configurada no servidor.<token>— token de identificação (userToken) fornecido pela equipe responsável pela API.
O dicionário lista cada objeto liberado com a descrição, os campos ou parâmetros de entrada, as colunas de retorno e um exemplo de uso pronto. Ele é o lugar certo para conferir o domínio de um campo — como os valores aceitos em OCI_INCOTERM ou em OCI_TIPOIMPORTA — e a assinatura exata de uma rotina antes de chamá-la.
Confirme no dicionário da sua instância se o objeto que você precisa está disponível para o seu token. O escopo varia por instalação e por token: um objeto citado aqui pode não estar liberado na sua. Se faltar, peça ao gestor do ERP a revisão do cadastro de API.
4. A regra de fronteira do módulo
Esta é a regra mais importante do módulo, e a que mais evita erro na primeira integração: o orçamento, o cadastro do processo e o markup se gravam direto; o cálculo e a geração do processo — a partir do orçamento ou de Ordens de Compra — passam por rotina; o restante do módulo é consulta.
| Como se trabalha | Objetos | O que observar |
|---|---|---|
Gravação diretaGET, POST, PUT, DELETE |
CEIORC1 (cabeçalho), CEIORC2 (itens), CEIORC3 (adições) e CEIORC4 (despesas e receitas) do Orçamento de Importação; CEIPROCESCAD (Processo de Importação); CEIPRODMARKUP (markup de importação por produto e filial) |
Gravar não calcula. Os valores do orçamento — FOB, frete, seguro, tributos, custo e datas das despesas — só são apurados quando você executa o cálculo. A partir de um orçamento, o processo nasce pela rotina de geração, que copia os dados do orçamento e grava o vínculo em CEIORC1.PIM_COD. A inclusão direta em CEIPROCESCAD cria sozinha, conforme o modelo de processo, a ordem de serviço de acompanhamento, o desdobramento de duplicatas e as previsões financeiras ou as provisões do processo, de acordo com a configuração. |
Só exclusãoGET, DELETE |
CEIORCVAR (variáveis do orçamento) |
As variáveis são gravadas pela retaguarda do ERP. Pela API, você as lê e as exclui quando exclui o orçamento inteiro. |
RotinaPATCH, GET |
CEI_PRC_CALCULAORCAMENTO (cálculo do orçamento) e CEI_PRC_GERAPROCESSORCAMENTO (geração do processo a partir do orçamento), executadas com PATCH; CEI_RES_GERAR_IMPORTACAO_OC (geração do orçamento e do processo a partir de Ordens de Compra), executada com GET |
O cálculo e a geração a partir do orçamento não devolvem dados. O cálculo grava os valores no próprio orçamento; leia-os por GET depois. A geração não devolve o código do processo: leia-o em CEIORC1.PIM_COD. A geração a partir de Ordens de Compra devolve resultado, por isso o GET, e grava o orçamento e o processo: confira SUCESSO no retorno antes de ler OCI_COD e PIM_COD. |
ConsultaGET |
CEIORC5 e CEIORC6 (vínculos do item com o Orçamento para Cliente e com a Ordem de Compra); o modelo de processo e as despesas dele (CEIPROCESMODELO, CEIPROCESMODELO6); os tipos de despesa (CEIPROCESTPDOC); as demais tabelas CEI* do processo, da declaração de importação e do follow-up; as previsões financeiras (DOCSPREVISAO); os documentos e títulos financeiros (DOCS, TITULO, TITULO2), lidos para conferir os títulos do processo; as Ordens de Compra (PED1, PED2), lidas para escolher as que geram o processo; as tabelas CMX*; as views do orçamento (CEI_VIEW_ORCTOTALORCAMENTO, CEI_VIEW_ORCTOTALADICAO, CEI_VIEW_TIPODOCUMENTO, CEI_VIEW_LISTADATAS); as views de saldo e de movimento da mercadoria da declaração de importação (CEI_VIEW_SALDOMERCADORIA, CEI_VIEW_SALDOMERCADORIANACIONALIZACAO, CEI_VIEW_MOVIMENTOMERCADORIA); as views CMX_VIEW_*; as rotinas de consulta de câmbio (CEI_RES_DOCUMENTOCAMBIO, CEI_RES_BAIXACAMBIO, CEI_RES_VARIACAOCAMBIAL), do financeiro do processo (CEI_RES_FINANCEIROPROCESSO), do fluxo de caixa do processo (CEI_PRC_RES_RESULTADOFIN), do extrato bancário por processo (CEI_RES_EXTRATOBANCARIO_PROCESSO) e do follow-up (CEI_RES_FOLLOWUP); os cadastros de apoio TMOV, INDICES, PRAZO, PRODUNI e PRODNCM |
Não grave nesses objetos. As rotinas de consulta são PROCEDURE RESULT, executadas com GET. CEIORC5 e CEIORC6 nascem quando a retaguarda do ERP gera o Orçamento para Cliente ou a Ordem de Compra a partir do orçamento de importação, ou capta itens de uma Ordem de Compra; CEIORC6 nasce também na geração a partir de Ordens de Compra. Se o dicionário da sua instância mostrar escrita liberada neles, peça ao gestor do ERP a revisão do cadastro de API. |
Gravar pela API não é o mesmo que preencher a tela. Ao escolher o modelo de processo, o produto ou o tipo de movimento, a tela do ERP copia valores desses cadastros para o orçamento e para o processo. Pela API, quem integra lê esses cadastros e envia os valores. O que o servidor preenche sozinho, e o que fica por sua conta, está indicado campo a campo na página do Orçamento de Importação e, para o processo gravado direto, na do Processo de Importação.
A liberação do módulo inclui também cadastros de outros domínios com escrita — CLIFOR1, CLIFOR3, PROD, PRODBARCOD, PRODEQUIV e PRODLOTE. Eles seguem as regras das páginas de Cadastro de Pessoas e de Cadastro de Produto.
5. Aviso sobre liberação na retaguarda
Antes de integrar, três coisas precisam estar prontas no ERP:
- Os objetos liberados para o seu token, no cadastro de API. Sem liberação do objeto, a chamada é recusada mesmo correta.
- A configuração da instância — ver a seção seguinte. Ela muda o comportamento do mesmo fluxo.
- Os cadastros de apoio: o modelo de processo com as despesas e receitas previstas, os tipos de despesa de importação, os tipos de documento com a data-base, os tipos de movimento de entrada e de saída, os produtos com NCM e peso, as pessoas (cliente, fornecedor e fabricante), a moeda e a condição de pagamento. Pessoas e produtos também podem ser gravados pela API, pelas regras das páginas de Cadastro de Pessoas e de Cadastro de Produto; os demais cadastros de apoio são mantidos na retaguarda do ERP.
6. Configuração da instância
Dois campos da configuração geral do ERP (CONFIG) fazem o mesmo fluxo se comportar de forma diferente em cada base. Confirme com o gestor do ERP como eles estão na sua instância antes de concluir que uma rotina falhou — em vários casos ela fez exatamente o que a configuração manda. O valor padrão dos dois é 0.
| Campo | Valor | O que o servidor faz |
|---|---|---|
CG_FT_USAPREVIAFINcontrole de previsões financeiras (descrição do campo no ERP: “Utilizar Controle de Apropriação de Receita”) |
0 |
Os tipos de despesa que não são despesa adicional de importação — os tributos de nacionalização e os valores de saída, marcados com TDP_DESPESA = 0 em CEI_VIEW_TIPODOCUMENTO — ficam fora do orçamento: as despesas do modelo desses tipos não são copiadas, e a inclusão de uma delas em CEIORC4 é recusada com O Tipo Financeiro T não é uma despesa adicional de importação. A geração do processo não lança previsões no financeiro: registra as provisões do processo em CEIPROCESPREVISAO, uma para cada despesa prevista no modelo (CEIPROCESMODELO6), com o valor previsto do tipo de despesa. A inclusão direta em CEIPROCESCAD registra as mesmas provisões. |
1 |
Todos os tipos de despesa e receita do modelo entram no orçamento, inclusive os tributos de nacionalização e os valores de saída. A geração do processo cria uma previsão financeira para cada despesa do orçamento que tenha pessoa (CEIORC4.CF_COD), com vencimento na data de previsão da despesa (OCI_DATAPREV). Previsão vinculada a processo exige prazo: uma despesa com pessoa e sem data de previsão faz a geração ser recusada, e nada é gravado. Na inclusão direta em CEIPROCESCAD, as previsões nascem das despesas com pessoa do modelo (CEIPROCESMODELO6) e das parcelas da condição de pagamento do câmbio (PZ_CODCAMBIO). Uma despesa com pessoa cuja condição de pagamento não tenha prazo em dias faz a inclusão ser recusada com a mensagem de prazo obrigatório. |
|
CG_PIM_SUGESTAOCODIGOsugestão do código interno do processo |
0 |
O processo recebe o código interno do orçamento (OCI_CODINTERNO) como veio. Um código interno já usado em outro processo é recusado com O código interno X já foi utilizado no processo Y. |
1 |
Na inclusão do processo, o código interno é substituído pelo número do processo (PIM_COD). |
|
2 |
Na inclusão do processo, o código interno é substituído pelo prefixo do cliente (CLIFOR1.CF_PREFIXOPROCESSO, três caracteres), um ponto, a sequência do cliente no ano com quatro dígitos, uma barra e o ano com dois dígitos — por exemplo, ABC.0001/26. Cliente sem prefixo faz a inclusão ser recusada com Configure uma Sigla única para o Cliente deste Processo antes de Salvar. |
Com CG_FT_USAPREVIAFIN = 1, cada despesa com pessoa precisa de data de previsão. Nas despesas de tipo previsto no modelo, o cálculo define essa data pela data-base configurada no tipo de documento da despesa (TPDOC.TD_CODDATABASE), somada ao prazo da condição de pagamento da despesa no modelo — na despesa de câmbio, ao prazo de cada parcela da condição de pagamento do orçamento. Configure a data-base na retaguarda e preencha no cabeçalho do orçamento a data que ela usa. Nas despesas de tipo que não está no modelo, envie OCI_DATAPREV. As data-bases aceitas, a mensagem de prazo e a ação correspondente estão no Passo 1 e em Validações e erros da página do Orçamento de Importação.
Com CG_PIM_SUGESTAOCODIGO em 1 ou 2, envie o código interno no orçamento mesmo assim. A geração do processo exige OCI_CODINTERNO preenchido antes de criar o processo, e a substituição acontece depois. Nesses dois modos, confira o código interno antes de gerar o processo: depois de gerado, a alteração do PIM_CODINTERNO é recusada com Não é permitido alterar o Código Interno do processo.
As mensagens desta página estão escritas como o servidor as define. Pela API, chegam precedidas de um prefixo com a operação e, fora da exclusão, sem acentos; o formato exato está em Validações e erros da página do Orçamento de Importação. T é o código do tipo de despesa (TDP_COD), X o código interno e Y o número do processo.
7. Encadeamento do módulo
Os fluxos se apoiam nesta ordem. Cada um pressupõe o anterior concluído; o processo que nasce de Ordens de Compra ou por gravação direta dispensa o orçamento montado por você.
- Cadastros de retaguarda — o modelo de processo, com os tipos de movimento e as despesas e receitas previstas; os tipos de despesa e os tipos de documento com data-base; os status de processo; os produtos com NCM e peso; as pessoas; a moeda e a condição de pagamento. São mantidos na retaguarda do ERP; pela API, você os lê para montar o orçamento. Pessoas e produtos também se gravam pela API.
- Orçamento de Importação — cabeçalho, itens, adições e despesas, gravados direto; depois, o cálculo, que apura os valores; por fim, a conferência dos totais. Toda alteração no orçamento pede um novo cálculo.
- Processo de Importação — gerado a partir do orçamento calculado, a partir de Ordens de Compra ou por gravação direta. Nos três caminhos, o processo nasce com as previsões financeiras ou as provisões do processo, conforme a configuração; a partir do orçamento, a rotina de geração grava também o vínculo no orçamento, e a partir de Ordens de Compra a rotina monta e calcula o orçamento antes de gerar o processo. Status, datas previstas e títulos seguem o processo, e os títulos são lançados pelo financeiro, com o rateio por processo. Estoque, câmbio, financeiro e follow-up se consultam por views e rotinas de consulta.
Altere e exclua o orçamento antes de gerar o processo. A geração copia os dados do orçamento para o processo naquele momento. Depois de gerado, as mudanças no orçamento não chegam ao processo, e uma segunda geração do mesmo orçamento é recusada informando que ele já esta vinculado ao processo de importação. Calcule por último, confira os totais, e só então gere.
8. As páginas do módulo
O ciclo completo pela API: o que ler do modelo e do produto, a ordem de gravação de cabeçalho, itens, adições e despesas, o que o servidor preenche e o que fica por sua conta, o cálculo e a conferência, a alteração, a exclusão e a geração do Processo de Importação.
Abrir guia →A criação do processo pelos três caminhos — a partir do orçamento, a partir de Ordens de Compra e por gravação direta —, a conferência, a alteração e as datas previstas, o status, os títulos do processo e as consultas de estoque, financeiro, fluxo de caixa e follow-up.
Abrir guia →9. Termos do módulo
- Orçamento de Importação
- A simulação de custo de uma importação antes de ela acontecer: mercadorias, tributos e despesas, com o custo de entrada e o preço base de saída. Identificado por
OCI_COD, emCEIORC1(cabeçalho),CEIORC2(itens),CEIORC3(adições) eCEIORC4(despesas e receitas). - Adição
- O agrupamento dos itens do orçamento por NCM, com um fornecedor e, se houver, um fabricante. Os percentuais de tributo são da adição, e não do item. Identificada por
OCI_ADICAO, dentro do orçamento. - INCOTERM
- A condição de compra negociada com o exportador, em
OCI_INCOTERM. Define o que compõe o preço:FOB,FCAeEXW, só o custo da mercadoria;CFReCPT, custo e frete;CIFeCIP, custo, frete e seguro. O cálculo exige o INCOTERM no orçamento. - FOB
- O valor da mercadoria sem o frete e o seguro internacionais. Apurado pelo cálculo em cada item, na moeda negociada (
OCI_VALORFOBMNEG) e em moeda nacional (OCI_VALORFOBMNAC). A geração do processo usa o FOB total para reconhecer um orçamento já calculado. - CIF
- O FOB somado ao frete e ao seguro internacionais. As despesas do orçamento cujo tipo de despesa de importação (
CEIPROCESTPDOC.TDP_TIPODESPIMP) é de acréscimo ou de dedução ao valor CIF da D.I. — tipos108e109emCEI_VIEW_TIPODOCUMENTO— alteram esse valor. - Moeda negociada e cotação
- A moeda da compra (
ID_COD, do cadastro de índices e moedas) e o valor dela em moeda nacional (OCI_IDCOTACAO). Os preços dos itens vão na moeda negociada (OCI_PRECOMNEG), e o cálculo os converte pela cotação. Uma despesa vai em moeda nacional (OCI_VALORMNAC) ou em moeda negociada, com moeda e cotação próprias. O cálculo exige a cotação no orçamento. - Modelo de processo
- O padrão de que o orçamento e o processo partem, em
CEIPROCESMODELO, identificado porMDL_COD: tipos de movimento de nacionalização e de saída, condição de pagamento, responsável, o que compõe o preço de saída (MDL_PRECO*) e as despesas e receitas previstas. Mantido na retaguarda do ERP. - Despesa do modelo
- Cada despesa ou receita prevista no modelo de processo, em
CEIPROCESMODELO6, com a incidência no custo (MDL_IMPCUSTO), a pessoa e a condição de pagamento. Entram no orçamento sozinhas, conforme a configuração: as de incidência no custo de entrada ou de saída (1a4) na inclusão do cabeçalho, as demais no cálculo. - Data-base
- A data de referência de onde sai a data de previsão de uma despesa do modelo. É configurada no tipo de documento da despesa (
TPDOC.TD_CODDATABASE), com as opções deCEI_VIEW_LISTADATAS, como Previsão de Chegada ou Previsão de Entrega. - Processo de Importação
- A importação em andamento, em
CEIPROCESCAD, identificada porPIM_COD. É dele que partem a declaração de importação, o câmbio e o follow-up. Nasce de um orçamento, de Ordens de Compra ou por gravação direta; quando vem de um orçamento, inclusive o que a geração a partir de Ordens de Compra monta, fica vinculado a ele emCEIORC1.PIM_COD. - Código interno
- O código de controle da empresa, com até 15 caracteres:
OCI_CODINTERNOno orçamento ePIM_CODINTERNOno processo. Exigido para gerar o processo e único entre os processos. Pode ser substituído na geração, conformeCG_PIM_SUGESTAOCODIGO.
10. Dica — identificar a tabela e o campo a partir da interface do ERP
Quando você souber o que quer gravar mas não souber onde, use a própria interface do ERP para descobrir. Com a tela do módulo aberta, pressione Ctrl + Alt + Shift + H: o título da janela muda, indicando que o modo de identificação está ativo. A partir daí, ao parar o mouse sobre um campo da tela, aparece uma dica com o nome da tabela e do campo a que ele está vinculado.
Com o nome da tabela e do campo em mãos, procure-os no dicionário da sua instância para confirmar o tipo, o domínio e se estão liberados para o seu token.
11. Relação com outros domínios
| Domínio | Como se relaciona com o COMEX Importação |
|---|---|
| Ordem de Compra | A retaguarda do ERP gera Ordens de Compra a partir do orçamento de importação e capta itens de Ordens de Compra para o orçamento. No sentido inverso, pela API, a rotina CEI_RES_GERAR_IMPORTACAO_OC gera o orçamento e o processo a partir de uma lista de Ordens de Compra de importação, descrita na página do Processo de Importação. O vínculo entre os itens dos dois fica em CEIORC6, para consulta. |
| Cadastro de Produto | Do produto vêm a NCM, a unidade, a descrição e os pesos bruto e líquido de cada item do orçamento. Para produto não genérico, a NCM do item precisa ser a do cadastro do produto. O markup de importação por produto e filial fica em CEIPRODMARKUP. |
| Cadastro de Pessoas | O cliente do orçamento, o fornecedor e o fabricante de cada adição e a pessoa de cada despesa são pessoas de CLIFOR1. O prefixo do cliente (CF_PREFIXOPROCESSO) compõe o código interno do processo quando CG_PIM_SUGESTAOCODIGO = 2. |
| Contas a Pagar/Receber | O título do processo é lançado com o rateio por processo, e com CG_FT_USAPREVIAFIN = 1 os títulos que têm previsão são efetivados na retaguarda do ERP: ver Contas a Pagar/Receber, Passos 9 e 11, e Processo de Importação, Passo 9. As consultas de contas a pagar e a receber (SPA_CONTASAPAGAR, SPA_CONTASARECEBER) fazem parte da liberação do módulo. |
| Controle de Anexos | O Orçamento e o Processo de Importação podem ter arquivos anexados. Eles são mantidos pelo endpoint de anexos, fora do integrador, e precisam ser removidos antes da exclusão do orçamento ou do processo: com anexo, a exclusão é recusada com Existem anexos vinculados a este registro. |
| Orçamento para Cliente | A retaguarda do ERP gera o Orçamento para Cliente a partir do orçamento de importação. O vínculo entre os itens fica em CEIORC5, para consulta, e o cálculo do orçamento de importação recalcula os Orçamentos para Cliente vinculados. |
12. Onde aprofundar
O dicionário da sua instância é a referência autoritativa: campos e domínios de cada tabela, assinatura de cada rotina e exemplo de uso pronto, sempre limitado ao que o seu token alcança.
O transporte — endereço, header userToken e requisição completa de cada method — está na Documentação da API, com as regras gerais de POST, PUT, DELETE e PATCH.
Para o fluxo, siga pela página do Orçamento de Importação e depois pela do Processo de Importação. Se o processo vai nascer de Ordens de Compra ou sem orçamento, comece direto pela página do Processo. Se você está integrando do zero, comece pelos cadastros de retaguarda da seção 7: sem o modelo de processo e as despesas dele configurados, o orçamento e o processo não têm de onde partir.