> For the complete documentation index, see [llms.txt](https://changelog.maino.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://changelog.maino.com.br/api-reference-maino/21.-custo-de-importacao.md).

# 21. 🧮 Custo De Importação

**Simulação do custo de importação item a item** Calcula, sem gravar nada, o custo de cada item de uma importação a partir do preço, da quantidade e do NCM — com o mesmo cálculo da tela de cotações internacionais. As alíquotas vêm da TEC vigente e da parametrização fiscal da empresa, nunca do payload. **Funcionalidades:**

* Rateio de frete, seguro e despesas por item
* II, IPI, PIS, COFINS, ICMS, FCP e substituição tributária por item, com a origem de cada alíquota
* Valores em moeda estrangeira e em reais, e totais do conjunto

## Simula o custo de importação item a item

> \*\*Calcula o custo de importação de cada item, sem gravar nada\*\*\
> \
> Recebe preço, quantidade e NCM de cada item, a moeda, o câmbio e as despesas do conjunto,\
> e devolve item a item: despesas rateadas, CIF, II, IPI, PIS, COFINS, ICMS, FCP e\
> substituição tributária, custo total e custo unitário — em moeda estrangeira e em reais.\
> O cálculo é o mesmo da tela de cotações internacionais.\
> \
> \*\*Despesas em dois blocos.\*\* \`frete\_e\_seguro\` traz o frete e o seguro na moeda da\
> operação. \`despesas\_nacionais\` traz, em reais, custos extras, Siscomex, AFRMM, capatazia,\
> antidumping e despesas do processo; cada valor é dividido pelo \`cambio\` antes do rateio.\
> \
> \*\*UF de destino vem do cadastro da empresa\*\* do usuário autenticado e é devolvida em\
> \`uf\_destino\`. Ela não é aceita no corpo: \`uf\_destino\` enviado, inclusive como \`null\`,\
> devolve 422 em \`/custo\_de\_importacao/uf\_destino\`. Empresa sem UF cadastrada devolve 422 em\
> \`/empresa/uf\`, sem calcular nada.\
> \
> \*\*Alíquotas nunca vêm do payload.\*\* II e IPI saem da TEC vigente do NCM; PIS e COFINS da\
> TEC, com o cadastro geral da empresa como alternativa; ICMS, FCP e MVA da parametrização\
> fiscal da empresa para o NCM. Cada imposto informa \`origem\_aliquota\`.\
> \
> \*\*Permissão:\*\* a mesma de leitura da tela de cotações.\
> \
> \*\*Limites:\*\* de 1 a 500 itens por requisição. Câmbio, quantidade e preço unitário menores\
> que 10^15; cada despesa, no valor enviado, menor que 10^17. Número aceito como número\
> JSON ou como texto de até 40 caracteres; \`NaN\` e \`Infinity\` são recusados. O corpo é\
> sempre JSON, e campo opcional da raiz enviado como \`null\` é tratado como omitido.\
> \
> \*\*Erros (422):\*\* saem no formato JSON Pointer. Erro de item é identificado pelo índice —\
> \`/itens/0/ncm\` para NCM sem TEC vigente ou sem parametrização, \`/itens/1/quantidade\`\
> para quantidade inválida. Campo conhecido no formato errado devolve 422 no ponteiro do\
> campo: objeto ou lista no lugar de um valor (\`/cambio\`, \`/frete\_e\_seguro/valor\_frete\`,\
> \`/despesas\_nacionais/valor\_siscomex\`, \`/itens/0/ncm\`), texto com caractere nulo\
> (\`/moeda\`), bloco de despesas que não é objeto (\`/frete\_e\_seguro\`, \`/despesas\_nacionais\`)\
> e item que não é objeto, inclusive \`null\` (\`/itens/0\`). Campo fora do contrato devolve\
> 422 no ponteiro do campo, como \`/custo\_de\_importacao/p\_ii\`,\
> \`/custo\_de\_importacao/frete\_e\_seguro/valor\_siscomex\` (despesa no bloco errado) ou\
> \`/custo\_de\_importacao/itens/0/p\_ii\`; o antigo bloco \`despesas\` devolve 422 em\
> \`/custo\_de\_importacao/despesas\`, inclusive quando enviado como \`null\`, assim como \`uf\_destino\`.\
> Corpo em outro formato, como formulário, ou com texto que não é UTF-8 válido devolve 422\
> em \`/custo\_de\_importacao\`; JSON malformado enviado como \`application/json\` é recusado\
> pelo Rails antes de chegar ao endpoint.

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"21. 🧮 Custo de Importação","description":"**Simulação do custo de importação item a item**\nCalcula, sem gravar nada, o custo de cada item de uma importação a partir do preço, da\nquantidade e do NCM — com o mesmo cálculo da tela de cotações internacionais. As\nalíquotas vêm da TEC vigente e da parametrização fiscal da empresa, nunca do payload.\n**Funcionalidades:**\n- Rateio de frete, seguro e despesas por item\n- II, IPI, PIS, COFINS, ICMS, FCP e substituição tributária por item, com a origem de cada alíquota\n- Valores em moeda estrangeira e em reais, e totais do conjunto"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}},"schemas":{"CustoDeImportacaoResultado":{"type":"object","description":"Custo de importação calculado item a item, com os totais do conjunto. Nada é gravado","properties":{"moeda":{"type":"string"},"cambio":{"type":"string","description":"Número decimal serializado como texto"},"uf_destino":{"type":"string","description":"UF do cadastro da empresa, usada no ICMS e no MVA"},"forma_rateio_frete":{"type":"string","enum":["quantidade","valor","peso"]},"itens":{"type":"array","items":{"type":"object","properties":{"pu":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"valor_mercadoria":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"valor_cif":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"custo_total":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"custo_unitario":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"referencia":{"type":"string"},"ncm":{"type":"string"},"quantidade":{"type":"string","description":"Número decimal serializado como texto"},"despesas_rateadas":{"type":"object","properties":{"valor_frete":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"valor_seguro":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"custos_extras":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"valor_siscomex":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"valor_taxa_afrmm":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"valor_capatazia":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"valor_antidumping":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"valor_despesas_processo":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]}}},"impostos":{"type":"object","properties":{"ii":{"type":"object","properties":{"base_de_calculo":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"aliquota":{"type":"string","description":"Alíquota em percentual"},"origem_aliquota":{"type":"string","enum":["tec","cadastro_geral_da_empresa","parametrizacao_da_empresa","nao_parametrizado"],"description":"De onde a alíquota veio: TEC vigente, cadastro geral da empresa, parametrização fiscal da empresa ou ausência de parametrização (alíquota zero)"},"valor":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]}},"required":["base_de_calculo","aliquota","origem_aliquota","valor"]},"ipi":{"type":"object","properties":{"base_de_calculo":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"aliquota":{"type":"string","description":"Alíquota em percentual"},"origem_aliquota":{"type":"string","enum":["tec","cadastro_geral_da_empresa","parametrizacao_da_empresa","nao_parametrizado"],"description":"De onde a alíquota veio: TEC vigente, cadastro geral da empresa, parametrização fiscal da empresa ou ausência de parametrização (alíquota zero)"},"valor":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]}},"required":["base_de_calculo","aliquota","origem_aliquota","valor"]},"pis":{"type":"object","properties":{"base_de_calculo":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"aliquota":{"type":"string","description":"Alíquota em percentual"},"origem_aliquota":{"type":"string","enum":["tec","cadastro_geral_da_empresa","parametrizacao_da_empresa","nao_parametrizado"],"description":"De onde a alíquota veio: TEC vigente, cadastro geral da empresa, parametrização fiscal da empresa ou ausência de parametrização (alíquota zero)"},"valor":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]}},"required":["base_de_calculo","aliquota","origem_aliquota","valor"]},"cofins":{"type":"object","properties":{"base_de_calculo":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"aliquota":{"type":"string","description":"Alíquota em percentual"},"origem_aliquota":{"type":"string","enum":["tec","cadastro_geral_da_empresa","parametrizacao_da_empresa","nao_parametrizado"],"description":"De onde a alíquota veio: TEC vigente, cadastro geral da empresa, parametrização fiscal da empresa ou ausência de parametrização (alíquota zero)"},"valor":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]}},"required":["base_de_calculo","aliquota","origem_aliquota","valor"]},"icms":{"type":"object","properties":{"base_de_calculo":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"aliquota":{"type":"string","description":"Alíquota em percentual"},"origem_aliquota":{"type":"string","enum":["tec","cadastro_geral_da_empresa","parametrizacao_da_empresa","nao_parametrizado"],"description":"De onde a alíquota veio: TEC vigente, cadastro geral da empresa, parametrização fiscal da empresa ou ausência de parametrização (alíquota zero)"},"valor":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]}},"required":["base_de_calculo","aliquota","origem_aliquota","valor"]},"fcp":{"type":"object","properties":{"base_de_calculo":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"aliquota":{"type":"string","description":"Alíquota em percentual"},"origem_aliquota":{"type":"string","enum":["tec","cadastro_geral_da_empresa","parametrizacao_da_empresa","nao_parametrizado"],"description":"De onde a alíquota veio: TEC vigente, cadastro geral da empresa, parametrização fiscal da empresa ou ausência de parametrização (alíquota zero)"},"valor":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]}},"required":["base_de_calculo","aliquota","origem_aliquota","valor"]},"fcp_st":{"type":"object","properties":{"base_de_calculo":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"aliquota":{"type":"string","description":"Alíquota em percentual"},"origem_aliquota":{"type":"string","enum":["tec","cadastro_geral_da_empresa","parametrizacao_da_empresa","nao_parametrizado"],"description":"De onde a alíquota veio: TEC vigente, cadastro geral da empresa, parametrização fiscal da empresa ou ausência de parametrização (alíquota zero)"},"valor":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]}},"required":["base_de_calculo","aliquota","origem_aliquota","valor"]},"icms_st":{"type":"object","properties":{"base_de_calculo":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"aliquota":{"type":"string","description":"Alíquota em percentual"},"origem_aliquota":{"type":"string","enum":["tec","cadastro_geral_da_empresa","parametrizacao_da_empresa","nao_parametrizado"],"description":"De onde a alíquota veio: TEC vigente, cadastro geral da empresa, parametrização fiscal da empresa ou ausência de parametrização (alíquota zero)"},"valor":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]},"mva":{"type":"string","description":"MVA em percentual da UF de destino"},"origem_mva":{"type":"string","enum":["tec","cadastro_geral_da_empresa","parametrizacao_da_empresa","nao_parametrizado"]}},"required":["base_de_calculo","aliquota","origem_aliquota","valor"]}}}}}},"totais":{"type":"object","description":"Soma dos itens para cada campo calculado","additionalProperties":{"type":"object","description":"Valor na moeda da operação e convertido para reais pelo câmbio informado","properties":{"moeda_estrangeira":{"type":"string","description":"Número decimal serializado como texto"},"reais":{"type":"string","description":"Número decimal serializado como texto"}},"required":["moeda_estrangeira","reais"]}}},"required":["moeda","cambio","uf_destino","forma_rateio_frete","itens","totais"]},"ErrosEstruturados":{"type":"object","description":"Envelope de erro de validação da API v2 de processos. Cada chave é um JSON Pointer para o campo recusado e o valor é a mensagem correspondente.","properties":{"errors":{"type":"object","description":"Objeto com os erros de validação no formato JSON Pointer","additionalProperties":{"type":"string"}}},"required":["errors"]},"CustoDeImportacaoInput":{"type":"object","description":"Corpo aceito por POST /estoque/fluxo_de_compra/custos_de_importacao (raiz `custo_de_importacao`), sempre em JSON e UTF-8: corpo em outro formato, como formulário, ou com texto que não é UTF-8 válido devolve 422 em `/custo_de_importacao`. Campo fora do contrato — inclusive qualquer alíquota — devolve 422 no ponteiro do campo, e campo conhecido no formato errado também: objeto, lista ou texto com caractere nulo no lugar de um valor, `frete_e_seguro` ou `despesas_nacionais` que não é objeto, item que não é objeto. A UF de destino não é aceita no corpo: vem sempre do cadastro da empresa do usuário autenticado, e `uf_destino` enviado, inclusive como `null`, devolve 422 em `/custo_de_importacao/uf_destino`. O antigo bloco `despesas` também saiu do contrato e devolve 422 em `/custo_de_importacao/despesas` (inclusive enviado como `null`). Campo opcional da raiz enviado como `null` é tratado como omitido. Número aceito como número JSON ou como texto de até 40 caracteres; NaN e Infinity devolvem 422.","properties":{"custo_de_importacao":{"type":"object","properties":{"moeda":{"type":"string","description":"Código ISO da moeda da operação"},"cambio":{"type":"number","description":"Taxa de câmbio para reais, maior ou igual a 0,000001 e menor que o máximo","minimum":0.000001,"maximum":1000000000000000,"exclusiveMaximum":true},"forma_rateio_frete":{"type":"string","enum":["quantidade","valor"],"description":"Rateio do frete entre os itens. Omitido, segue a configuração da empresa: com \"Por peso\", rateia pelo peso líquido (`peso_liquido_unitario` × `quantidade`) quando todos os itens informam peso maior que zero, e pelo valor quando falta peso em algum; com \"Por FOB\", rateia pelo valor"},"frete_e_seguro":{"type":"object","description":"Frete e seguro do conjunto, na moeda da operação. O frete é rateado conforme `forma_rateio_frete` e o seguro pelo valor dos itens. Opcionais, zero quando omitidos, nunca negativos, menores que o máximo","properties":{"valor_frete":{"type":"number","maximum":100000000000000000,"exclusiveMaximum":true},"valor_seguro":{"type":"number","maximum":100000000000000000,"exclusiveMaximum":true}}},"despesas_nacionais":{"type":"object","description":"Despesas nacionais do conjunto, em reais. Cada valor é dividido pelo `cambio` para a moeda da operação e então rateado pelo valor dos itens. Opcionais, zero quando omitidas, nunca negativas e, em reais, menores que o máximo","properties":{"custos_extras":{"type":"number","maximum":100000000000000000,"exclusiveMaximum":true},"valor_siscomex":{"type":"number","maximum":100000000000000000,"exclusiveMaximum":true},"valor_taxa_afrmm":{"type":"number","maximum":100000000000000000,"exclusiveMaximum":true},"valor_capatazia":{"type":"number","maximum":100000000000000000,"exclusiveMaximum":true},"valor_antidumping":{"type":"number","maximum":100000000000000000,"exclusiveMaximum":true},"valor_despesas_processo":{"type":"number","maximum":100000000000000000,"exclusiveMaximum":true}}},"itens":{"type":"array","minItems":1,"maxItems":500,"items":{"type":"object","properties":{"referencia":{"type":"string","maxLength":255,"description":"Identificador do item devolvido na resposta"},"ncm":{"type":"string","description":"NCM com 8 dígitos, com ou sem pontos"},"quantidade":{"type":"number","description":"Quantidade, maior ou igual a 0,000001 e menor que o máximo","minimum":0.000001,"maximum":1000000000000000,"exclusiveMaximum":true},"pu":{"type":"number","description":"Preço unitário na moeda da operação, não negativo e menor que o máximo","maximum":1000000000000000,"exclusiveMaximum":true},"peso_liquido_unitario":{"type":"number","description":"Peso líquido unitário do item, não negativo e menor que o máximo. Opcional; usado no rateio do frete por peso","maximum":1000000000000000,"exclusiveMaximum":true}},"required":["referencia","ncm","quantidade","pu"]}}},"required":["moeda","cambio","itens"]}},"required":["custo_de_importacao"]}}},"paths":{"/estoque/fluxo_de_compra/custos_de_importacao":{"post":{"summary":"Simula o custo de importação item a item","tags":["21. 🧮 Custo de Importação"],"description":"**Calcula o custo de importação de cada item, sem gravar nada**\n\nRecebe preço, quantidade e NCM de cada item, a moeda, o câmbio e as despesas do conjunto,\ne devolve item a item: despesas rateadas, CIF, II, IPI, PIS, COFINS, ICMS, FCP e\nsubstituição tributária, custo total e custo unitário — em moeda estrangeira e em reais.\nO cálculo é o mesmo da tela de cotações internacionais.\n\n**Despesas em dois blocos.** `frete_e_seguro` traz o frete e o seguro na moeda da\noperação. `despesas_nacionais` traz, em reais, custos extras, Siscomex, AFRMM, capatazia,\nantidumping e despesas do processo; cada valor é dividido pelo `cambio` antes do rateio.\n\n**UF de destino vem do cadastro da empresa** do usuário autenticado e é devolvida em\n`uf_destino`. Ela não é aceita no corpo: `uf_destino` enviado, inclusive como `null`,\ndevolve 422 em `/custo_de_importacao/uf_destino`. Empresa sem UF cadastrada devolve 422 em\n`/empresa/uf`, sem calcular nada.\n\n**Alíquotas nunca vêm do payload.** II e IPI saem da TEC vigente do NCM; PIS e COFINS da\nTEC, com o cadastro geral da empresa como alternativa; ICMS, FCP e MVA da parametrização\nfiscal da empresa para o NCM. Cada imposto informa `origem_aliquota`.\n\n**Permissão:** a mesma de leitura da tela de cotações.\n\n**Limites:** de 1 a 500 itens por requisição. Câmbio, quantidade e preço unitário menores\nque 10^15; cada despesa, no valor enviado, menor que 10^17. Número aceito como número\nJSON ou como texto de até 40 caracteres; `NaN` e `Infinity` são recusados. O corpo é\nsempre JSON, e campo opcional da raiz enviado como `null` é tratado como omitido.\n\n**Erros (422):** saem no formato JSON Pointer. Erro de item é identificado pelo índice —\n`/itens/0/ncm` para NCM sem TEC vigente ou sem parametrização, `/itens/1/quantidade`\npara quantidade inválida. Campo conhecido no formato errado devolve 422 no ponteiro do\ncampo: objeto ou lista no lugar de um valor (`/cambio`, `/frete_e_seguro/valor_frete`,\n`/despesas_nacionais/valor_siscomex`, `/itens/0/ncm`), texto com caractere nulo\n(`/moeda`), bloco de despesas que não é objeto (`/frete_e_seguro`, `/despesas_nacionais`)\ne item que não é objeto, inclusive `null` (`/itens/0`). Campo fora do contrato devolve\n422 no ponteiro do campo, como `/custo_de_importacao/p_ii`,\n`/custo_de_importacao/frete_e_seguro/valor_siscomex` (despesa no bloco errado) ou\n`/custo_de_importacao/itens/0/p_ii`; o antigo bloco `despesas` devolve 422 em\n`/custo_de_importacao/despesas`, inclusive quando enviado como `null`, assim como `uf_destino`.\nCorpo em outro formato, como formulário, ou com texto que não é UTF-8 válido devolve 422\nem `/custo_de_importacao`; JSON malformado enviado como `application/json` é recusado\npelo Rails antes de chegar ao endpoint.","parameters":[],"responses":{"200":{"description":"Custo de importação calculado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustoDeImportacaoResultado"}}}},"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"422":{"description":"Payload recusado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrosEstruturados"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustoDeImportacaoInput"}}},"required":true}}}}}
```
