> 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/models.md).

# Models

## The Error object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"Error":{"type":"object","description":"Schema padrão para respostas de erro da API","properties":{"error":{"type":"string","description":"Mensagem de erro amigável para o usuário"},"details":{"type":"string","description":"Detalhes técnicos do erro (opcional)"},"code":{"type":"integer","description":"Código interno de erro para debugging"},"timestamp":{"type":"string","format":"datetime","description":"Timestamp do erro"},"request_id":{"type":"string","description":"ID único da requisição para rastreamento"}},"required":["error","timestamp"]}}}}
```

## The ValidationErrors object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"ValidationErrors":{"type":"object","description":"Schema para erros de validação de formulários e dados","properties":{"errors":{"type":"array","items":{"type":"string"},"description":"Lista detalhada de erros de validação encontrados"},"field_errors":{"type":"object","description":"Mapa de erros por campo específico","additionalProperties":{"type":"array","items":{"type":"string"}}}},"required":["errors"]}}}}
```

## The SimpleError object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"SimpleError":{"type":"object","description":"Formato canônico de erro estruturado da API v2, renderizado por `app/views/api/v2/shared/_simple_error.json.jbuilder`. O objeto `fields` é omitido quando o erro não é atribuível a campos específicos (ex.: 404).","properties":{"errors":{"type":"object","properties":{"message":{"type":"string","description":"Mensagem principal do erro, pronta para exibição"},"fields":{"type":"object","description":"Mapa de campo para a lista de motivos. Omitido quando não há campo envolvido.","additionalProperties":{"type":"array","items":{"type":"string"}}}}}},"required":["errors"]}}}}
```

## The ProcessoInput object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"ProcessoInput":{"type":"object","description":"Corpo aceito por POST /processos (raiz `processo`). Apenas `tipo` e `via` são obrigatórios.","properties":{"tipo":{"type":"string","enum":["importacao","exportacao","aquisicao"],"description":"Tipo do processo. Obrigatório."},"via":{"type":"string","enum":["maritima","aerea","rodoviaria"],"description":"Via de transporte. Obrigatório."},"modalidade":{"type":"string","enum":["importacao_direta","conta_e_ordem","encomenda"],"description":"Modalidade da importação."},"incoterm":{"type":"string","enum":["EXW","FCA","CPT","CIP","DAP","DPU","DDP","FAS","FOB","CFR","CIF"],"description":"Incoterm da operação."},"codigo":{"type":"string","description":"Código do processo. Quando ausente ou em branco, o servidor gera o próximo código da empresa."},"moeda_codigo_iso":{"type":"string","description":"Sigla ISO da moeda (ex: 'USD', 'BRL'). Resolvida contra o cadastro de moedas — sigla inexistente devolve 422 em /moeda_codigo_iso, sem fallback para BRL."},"cliente_razao_social":{"type":"string","description":"Razão social do cliente (busca parcial entre os clientes da empresa)."},"cliente_documento":{"type":"string","description":"CNPJ/CPF do cliente (busca exata, normalizada). Precede cliente_razao_social quando ambos vêm."},"fornecedor_razao_social":{"type":"string","description":"Razão social do fornecedor (busca parcial entre os fornecedores da empresa)."},"fornecedor_documento":{"type":"string","description":"CNPJ/CPF do fornecedor (busca exata, normalizada). Precede fornecedor_razao_social quando ambos vêm."},"importador_razao_social":{"type":"string","description":"Razão social do importador (busca parcial entre os stakeholders da empresa)."},"importador_documento":{"type":"string","description":"CNPJ/CPF do importador (busca exata, normalizada). Precede importador_razao_social quando ambos vêm."},"despachante_razao_social":{"type":"string","description":"Razão social do despachante aduaneiro (busca parcial entre os despachantes da empresa)."},"despachante_documento":{"type":"string","description":"CNPJ/CPF do despachante aduaneiro (busca exata, normalizada). Precede despachante_razao_social quando ambos vêm."},"agente_carga_razao_social":{"type":"string","description":"Razão social do agente de carga (busca parcial entre os agentes de carga da empresa)."},"agente_carga_documento":{"type":"string","description":"CNPJ/CPF do agente de carga (busca exata, normalizada). Precede agente_carga_razao_social quando ambos vêm."},"pessoa_responsavel_id":{"type":"integer","description":"ID da Pessoa responsável pelo processo, resolvido entre as pessoas da empresa. Atenção: a chave é pessoa_responsavel_id — pessoa_responsavel devolve 422 de campo desconhecido."},"data_pedido":{"type":"string","format":"date","description":"Data do pedido."},"data_purchase_order":{"type":"string","format":"date","description":"Data da Purchase Order (campo legado)."},"data_cambio_antecipacao":{"type":"string","format":"date","description":"Data do câmbio de antecipação."},"data_embarque":{"type":"string","format":"date-time","description":"Data de embarque."},"eta":{"type":"string","format":"date-time","description":"ETA — chegada estimada."},"data_chegada":{"type":"string","format":"date-time","description":"Data de chegada."},"numerario_cambio":{"type":"number","description":"Numerário de câmbio."},"array_custom_tags":{"type":"array","items":{"type":"string"},"description":"Nomes das custom tags a vincular ao processo."},"descricao":{"type":"string","description":"Descrição do processo."},"numero_invoice":{"type":"string","description":"Número da invoice."},"condicao_pagamento":{"type":"string","description":"Condição de pagamento."},"categoria":{"type":"string","description":"Categoria do processo."},"observacao":{"type":"string","description":"Observações."},"outra_referencia":{"type":"string","description":"Outra referência."},"codigo_purchase_order":{"type":"string","description":"Código da Purchase Order (campo legado)."},"campanhia_aerea":{"type":"string","description":"Companhia aérea (grafia da coluna). Prevalece sobre companhia_aerea quando ambas vêm no mesmo payload."},"companhia_aerea":{"type":"string","description":"Companhia aérea (apelido de escrita aceito). Gravado em campanhia_aerea, que é a grafia devolvida na resposta."},"numero_do_voo":{"type":"string","description":"Número do voo."}},"required":["tipo","via"]}}}}
```

## The ErrosEstruturados object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"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"]}}}}
```

## The OcorrenciaDaImportacaoDeXml object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"OcorrenciaDaImportacaoDeXml":{"type":"object","description":"Erro ou aviso da importação de XML de NF-e. O `codigo` é estável e deve ser usado pelo integrador para decidir o que fazer; a `mensagem` é texto para pessoas e pode mudar.","properties":{"codigo":{"type":"string","description":"Código estável da ocorrência"},"mensagem":{"type":"string","description":"Descrição legível da ocorrência"},"detalhe":{"type":"string","nullable":true,"description":"Complemento da ocorrência: o campo recusado em `parametro_invalido` e `xml_acima_do_limite`, ou as mensagens de validação em `registro_invalido` e `importacao_incompleta`"}},"required":["codigo","mensagem","detalhe"]}}}}
```

## The ResultadoDaImportacaoDeXml object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"ResultadoDaImportacaoDeXml":{"type":"object","description":"Registro criado pela importação de XML de NF-e","properties":{"status":{"type":"string","enum":["criada","criada_com_avisos"],"description":"`criada_com_avisos` indica que o registro foi gravado, mas algum lançamento (estoque ou títulos) ficou incompleto: leia `avisos`"},"registro_tipo":{"type":"string","enum":["nota_fiscal","compra"],"description":"`nota_fiscal` quando a empresa é a emitente; `compra` quando é a destinatária"},"registro_id":{"type":"integer","description":"ID do registro criado"},"avisos":{"type":"array","description":"Avisos da importação; vazio quando `status` é `criada`","items":{"$ref":"#/components/schemas/OcorrenciaDaImportacaoDeXml"}}},"required":["status","registro_tipo","registro_id","avisos"]},"OcorrenciaDaImportacaoDeXml":{"type":"object","description":"Erro ou aviso da importação de XML de NF-e. O `codigo` é estável e deve ser usado pelo integrador para decidir o que fazer; a `mensagem` é texto para pessoas e pode mudar.","properties":{"codigo":{"type":"string","description":"Código estável da ocorrência"},"mensagem":{"type":"string","description":"Descrição legível da ocorrência"},"detalhe":{"type":"string","nullable":true,"description":"Complemento da ocorrência: o campo recusado em `parametro_invalido` e `xml_acima_do_limite`, ou as mensagens de validação em `registro_invalido` e `importacao_incompleta`"}},"required":["codigo","mensagem","detalhe"]}}}}
```

## The ErrosDaImportacaoDeXml object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"ErrosDaImportacaoDeXml":{"type":"object","description":"Recusa da importação de XML de NF-e. Nada é gravado quando a importação é recusada.","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/OcorrenciaDaImportacaoDeXml"}}},"required":["errors"]},"OcorrenciaDaImportacaoDeXml":{"type":"object","description":"Erro ou aviso da importação de XML de NF-e. O `codigo` é estável e deve ser usado pelo integrador para decidir o que fazer; a `mensagem` é texto para pessoas e pode mudar.","properties":{"codigo":{"type":"string","description":"Código estável da ocorrência"},"mensagem":{"type":"string","description":"Descrição legível da ocorrência"},"detalhe":{"type":"string","nullable":true,"description":"Complemento da ocorrência: o campo recusado em `parametro_invalido` e `xml_acima_do_limite`, ou as mensagens de validação em `registro_invalido` e `importacao_incompleta`"}},"required":["codigo","mensagem","detalhe"]}}}}
```

## The Processo object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"Processo":{"type":"object","description":"Processo de comércio exterior serializado pela API v2. Mesma forma devolvida pelo item do GET /processos, pelo 201 do POST /processos e pelos 200 dos endpoints de vínculo de documento e de ordem de compra.","properties":{"id":{"type":"integer","description":"ID do processo"},"uuid":{"type":"string","format":"uuid","description":"Identificador público do processo (usado nos paths de vínculo)"},"numero":{"type":"string","description":"Código do processo"},"descricao":{"type":"string","nullable":true,"description":"Descrição do processo"},"data_criacao":{"type":"string","description":"Data e hora de criação"},"cliente":{"type":"string","nullable":true,"description":"Razão social do cliente"},"modalidade":{"type":"string","nullable":true,"description":"Modalidade do processo"},"tipo":{"type":"string","nullable":true,"description":"Tipo (importação/exportação)"},"via":{"type":"string","nullable":true,"description":"Via de transporte (marítima/aérea/terrestre)"},"categoria":{"type":"string","nullable":true,"description":"Categoria do processo"},"etapa":{"type":"string","nullable":true,"description":"Etapa atual do processo"},"canal":{"type":"string","nullable":true,"description":"Canal de parametrização"},"vmle":{"type":"number","format":"float","nullable":true,"description":"Valor da mercadoria no local de embarque"},"frete":{"type":"number","format":"float","nullable":true,"description":"Valor do frete"},"seguro":{"type":"number","format":"float","nullable":true,"description":"Valor do seguro"},"vmld":{"type":"number","format":"float","nullable":true,"description":"Valor da mercadoria no local de descarga"},"fornecedor":{"type":"string","nullable":true,"deprecated":true,"description":"DEPRECADO — apesar do nome, devolve o IMPORTADOR, não o fornecedor: documento e razão social no formato \"<documento> - <razão social>\" (só a razão social quando não há documento; nome, tipo e valor mantidos por compatibilidade). O fornecedor principal do processo está em stakeholder_fornecedor; a lista de fornecedores, no array fornecedores; o importador estruturado, em importador."},"container":{"type":"string","nullable":true,"description":"Número do container"},"outra_referencia":{"type":"string","nullable":true,"description":"Outra referência"},"condicao_pagamento":{"type":"string","nullable":true,"description":"Condição de pagamento"},"data_cambio_antecipacao":{"type":"string","format":"date","nullable":true,"description":"Data do câmbio de antecipação"},"codigo_purchase_order":{"type":"string","nullable":true,"deprecated":true,"description":"DEPRECADO — usar o bloco ordem_de_compra (numero). Código da Purchase Order (string livre legada, mantido por compatibilidade)."},"data_purchase_order":{"type":"string","format":"date","nullable":true,"deprecated":true,"description":"DEPRECADO — usar o bloco ordem_de_compra. Data da Purchase Order (string livre legada, mantido por compatibilidade)."},"observacao":{"type":"string","nullable":true,"description":"Observações"},"companhia_aerea":{"type":"string","nullable":true,"description":"Companhia aérea"},"numero_do_voo":{"type":"string","nullable":true,"description":"Número do voo"},"navio":{"type":"string","nullable":true,"description":"Nome do navio"},"placa_do_veiculo_transportador":{"type":"string","nullable":true,"description":"Placa do veículo"},"armador":{"type":"string","nullable":true,"description":"Armador"},"conhecimento_de_embarque":{"type":"string","nullable":true,"description":"Conhecimento de embarque"},"pais_procedencia":{"type":"string","nullable":true,"description":"País de procedência"},"embarque":{"type":"string","nullable":true,"description":"Local de embarque"},"data_embarque":{"type":"string","format":"date","nullable":true,"description":"Data de embarque"},"pais_destino":{"type":"string","nullable":true,"description":"País de destino"},"desembarque":{"type":"string","nullable":true,"description":"Local de desembarque"},"data_chegada":{"type":"string","format":"date","nullable":true,"description":"Data de chegada"},"eta":{"type":"string","format":"date","nullable":true,"description":"ETA (Estimated Time of Arrival)"},"agente_de_carga":{"type":"string","nullable":true,"deprecated":true,"description":"DEPRECADO — usar o objeto agente_carga (id/razao_social/documento). Agente de carga (string legada, mantida por compatibilidade)."},"stakeholder_agente_carga_id":{"type":"integer","nullable":true,"description":"ID do stakeholder agente de carga"},"bl":{"type":"string","nullable":true,"description":"Número do BL (via marítima)"},"data_emissao_bl":{"type":"string","format":"date","nullable":true,"description":"Data de emissão do BL"},"awb":{"type":"string","nullable":true,"description":"Número do AWB (via aérea)"},"data_emissao_awb":{"type":"string","format":"date","nullable":true,"description":"Data de emissão do AWB"},"crt":{"type":"string","nullable":true,"description":"Número do CRT (via terrestre)"},"data_emissao_crt":{"type":"string","format":"date","nullable":true,"description":"Data de emissão do CRT"},"fci":{"type":"string","nullable":true,"description":"FCI"},"incoterm":{"type":"string","nullable":true,"description":"Incoterm utilizado"},"peso_bruto":{"type":"number","format":"float","nullable":true,"description":"Peso bruto em kg"},"peso_liquido":{"type":"number","format":"float","nullable":true,"description":"Peso líquido em kg"},"status_container":{"type":"string","nullable":true,"description":"Status do container"},"presenca_carga":{"type":"string","nullable":true,"description":"Presença da carga"},"numero_invoice":{"type":"string","nullable":true,"description":"Número da invoice"},"valor_invoice":{"type":"number","format":"float","nullable":true,"description":"Valor da invoice"},"vencimento_invoice":{"type":"string","format":"date","nullable":true,"description":"Vencimento da invoice"},"data_cambio_saldo":{"type":"string","format":"date","nullable":true,"description":"Data do câmbio do saldo"},"terminal_de_armazenagem":{"type":"string","nullable":true,"description":"Terminal de armazenagem"},"data_pedido":{"type":"string","format":"date","nullable":true,"description":"Data do pedido (AAAA-MM-DD). Mesmo campo aceito no POST/PATCH."},"numerario_cambio":{"type":"string","nullable":true,"description":"Numerário de câmbio (decimal serializado como string). Mesmo campo aceito no POST/PATCH."},"moeda_codigo_iso":{"type":"string","nullable":true,"description":"Sigla ISO da moeda do processo (ex: USD). Espelha o campo moeda_codigo_iso do POST/PATCH."},"etapa_processo_id":{"type":"string","format":"uuid","description":"Identificador da etapa atual do processo. A chave etapa continua devolvendo a descrição."},"importador":{"type":"object","nullable":true,"description":"Stakeholder importador do processo. Null quando não há importador.","properties":{"id":{"type":"integer","description":"ID do Stakeholder"},"razao_social":{"type":"string","description":"Razão social do importador"},"documento":{"type":"string","nullable":true,"description":"CNPJ/CPF do importador (numero_do_documento na origem)."}}},"stakeholder_fornecedor":{"type":"object","nullable":true,"description":"Stakeholder fornecedor do processo (coluna stakeholder_fornecedor_id, preenchida por fornecedor_documento/fornecedor_razao_social no POST). Null quando não há fornecedor. Não confundir com a chave legada fornecedor, que devolve o importador.","properties":{"id":{"type":"integer","description":"ID do Stakeholder"},"razao_social":{"type":"string","description":"Razão social do fornecedor"},"documento":{"type":"string","nullable":true,"description":"CNPJ/CPF do fornecedor (numero_do_documento na origem)."}}},"stakeholder_cliente":{"type":"object","nullable":true,"description":"Stakeholder cliente do processo. Null quando não há cliente. A chave cliente continua devolvendo só a razão social.","properties":{"id":{"type":"integer","description":"ID do Stakeholder"},"razao_social":{"type":"string","description":"Razão social do cliente"},"documento":{"type":"string","nullable":true,"description":"CNPJ/CPF do cliente (numero_do_documento na origem)."}}},"anexos":{"type":"array","nullable":true,"description":"Anexos do processo","items":{"type":"object","properties":{"anexo":{"type":"object","properties":{"url":{"type":"string","description":"URL do anexo"}}}}}},"di":{"type":"object","nullable":true,"description":"Declaração de Importação","properties":{"codigo":{"type":"string","nullable":true,"description":"Código da DI"},"data_de_desembaraco":{"type":"string","format":"date","nullable":true,"description":"Data de desembaraço"},"data_registro":{"type":"string","format":"date","nullable":true,"description":"Data de registro"}}},"responsavel":{"type":"object","nullable":true,"description":"Pessoa responsável pelo processo (campo Q2). A edição da Pessoa vinculada reflete no próximo GET (cache key do fragmento inclui a associação — Slice 5).","properties":{"id":{"type":"integer","description":"ID da Pessoa"},"nome":{"type":"string","description":"Nome da Pessoa"},"foto_url":{"type":"string","nullable":true,"description":"URL da foto de perfil (CarrierWave). Null se sem upload."}}},"despachante":{"type":"object","nullable":true,"description":"Stakeholder despachante do processo (campo Q2).","properties":{"id":{"type":"integer","description":"ID do Stakeholder"},"razao_social":{"type":"string","description":"Razão social do despachante"},"documento":{"type":"string","nullable":true,"description":"CNPJ/CPF do despachante (numero_do_documento na origem)."}}},"agente_carga":{"type":"object","nullable":true,"description":"Objeto stakeholder do agente de carga (campo Q2). Coexiste com agente_de_carga (string legada) e stakeholder_agente_carga_id (int legado).","properties":{"id":{"type":"integer","description":"ID do Stakeholder"},"razao_social":{"type":"string","description":"Razão social do agente de carga"},"documento":{"type":"string","nullable":true,"description":"CNPJ/CPF do agente de carga."}}},"data_embarque_previsto":{"type":"string","format":"date","nullable":true,"description":"ETD — data prevista de embarque (campo Q2)."},"incoterm_legado":{"type":"string","nullable":true,"description":"Valor de incoterm fora do enum normalizado (ex: 'EXX'). Coexiste com incoterm (campo Q2)."},"fornecedores":{"type":"array","description":"Fornecedores M:N do processo (campo Q2). Sempre array — vazio quando não houver fornecedores, nunca null. Coexiste com o campo legado 'fornecedor' (string derivada do importador). Adicionar/remover fornecedor reflete no próximo GET (cache key do fragmento inclui a associação M:N — Slice 5).","items":{"type":"object","properties":{"id":{"type":"integer","description":"ID do Stakeholder fornecedor"},"razao_social":{"type":"string","description":"Razão social do fornecedor"},"documento":{"type":"string","nullable":true,"description":"CNPJ/CPF do fornecedor (numero_do_documento na origem)."}}}},"tags":{"type":"array","description":"Nomes das custom tags vinculadas ao processo (campo Q2). Sempre array — vazio quando não houver tags, nunca null. Adicionar/remover tag reflete no próximo GET (cache key do fragmento inclui a associação M:N — Slice 5).","items":{"type":"string"}},"conteineres":{"type":"array","description":"Lista de contêineres do processo (campo Q2). O item com monitorado: true é o contêiner principal cujos numero/peso_bruto/peso_liquido são refletidos no nível do processo (apenas um por processo). Editar o contêiner (inclusive os campos de demurrage) reflete no próximo GET (cache key do fragmento inclui a associação conteineres — Slice 5). Atenção: não confundir moeda_tarifa: 'USD' com dado intencional quando free_time é null, pois USD é o default do banco.","items":{"type":"object","properties":{"numero":{"type":"string","nullable":true,"description":"Número de identificação do contêiner"},"peso_bruto":{"type":"number","format":"float","nullable":true,"description":"Peso bruto em kg"},"peso_liquido":{"type":"number","format":"float","nullable":true,"description":"Peso líquido em kg"},"monitorado":{"type":"boolean","description":"Quando true, este é o contêiner principal do processo (apenas um por processo)"},"free_time":{"type":"integer","nullable":true,"description":"Free time em dias contratado com o armador"},"tarifa_demurrage":{"type":"string","nullable":true,"description":"Tarifa de demurrage por dia após o free time (decimal 15,2 serializado como string)"},"moeda_tarifa":{"type":"string","nullable":true,"enum":["BRL","USD"],"description":"Moeda da tarifa_demurrage (BRL ou USD). Default USD no banco — não confundir com dado intencional quando free_time é null"},"inicio_free_time":{"type":"string","format":"date","nullable":true,"description":"Data de início do free time (ISO 8601)"},"data_devolucao":{"type":"string","format":"date","nullable":true,"description":"Data de devolução do contêiner ao armador (ISO 8601)"}}}},"ordem_de_compra":{"type":"object","nullable":true,"description":"Ordem de Compra vinculada ao processo e itens alocados (campo Q2, Slice 4). Substitui os campos legados codigo_purchase_order/data_purchase_order (strings livres, deprecados) pelo vínculo estruturado 1:1 com a OC. Omitido (chave ausente, não null) quando não há OC vinculada. Renderizado fora do fragmento cacheado por-processo (sempre resolve no GET, padrão di/anexos — Slice 4).","properties":{"id":{"type":"integer","description":"ID da Ordem de Compra"},"numero":{"type":"string","description":"Número identificador da Ordem de Compra (OrdemDeCompra#numero)"},"itens":{"type":"array","description":"Itens da OC alocados ao processo. Array vazio quando a OC está vinculada mas sem itens alocados.","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do vínculo item-OC-processo (UUID)"},"item_ordem_de_compra_id":{"type":"integer","description":"ID do item da Ordem de Compra alocado"},"quantidade_alocada":{"type":"string","description":"Quantidade alocada ao processo (decimal 15,4 serializado como string)"}}}}}},"notas_fiscais_vinculadas":{"type":"array","description":"NF-es vinculadas ao processo — a mesma lista da seção \"NF-es vinculadas\" da tela: notas com este processo atribuído, ou sem processo e com a mesma DI/DUIMP do processo, nas situações aceita e finalizada, em ordem de id. Sempre array — vazio quando não há nota, nunca null. Renderizado fora do fragmento cacheado por-processo: vincular, desvincular ou mudar a situação da nota reflete no próximo GET.","items":{"type":"object","properties":{"id":{"type":"integer","description":"ID da NF-e"},"numero":{"type":"integer","nullable":true,"description":"Número da NF-e"},"serie":{"type":"integer","nullable":true,"description":"Série da NF-e"},"chave_acesso":{"type":"string","nullable":true,"description":"Chave de acesso de 44 dígitos. Null quando a nota não tem chave gravada."},"tipo":{"type":"string","nullable":true,"enum":["entrada","saida"],"description":"Tipo da NF-e: entrada ou saida"},"data_emissao":{"type":"string","format":"date-time","description":"Data e hora de emissão (ISO 8601)"},"valor_total":{"type":"number","format":"float","description":"Total da NF-e com 2 casas decimais — o mesmo valor da coluna \"Total da NF-e\" da tela"},"situacao":{"type":"string","enum":["aceita","finalizada"],"description":"Situação da NF-e: aceita ou finalizada"}},"required":["id","numero","serie","chave_acesso","tipo","data_emissao","valor_total","situacao"]}}},"required":["id","numero","notas_fiscais_vinculadas"]}}}}
```

## The Pagination object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"Pagination":{"type":"object","description":"Informações de paginação - Schema genérico (não usado diretamente, ver StakeholdersPagination e ProdutosPagination)","properties":{"total":{"type":"integer","description":"Total de páginas ou registros (varia por endpoint)","minimum":0},"count":{"type":"integer","description":"Contagem de registros (apenas em alguns endpoints)","minimum":0},"previous_page":{"type":"string","format":"uri","nullable":true,"description":"URL completa da página anterior (null se for a primeira página)"},"next_page":{"type":"string","format":"uri","nullable":true,"description":"URL completa da próxima página (null se for a última página)"}}}}}}
```

## The StakeholdersPagination object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"StakeholdersPagination":{"type":"object","description":"Paginação específica do endpoint de stakeholders (baseado no index.json.jbuilder real)","properties":{"total":{"type":"integer","description":"Total de páginas disponíveis","minimum":0},"count":{"type":"integer","description":"Quantidade de registros retornados nesta página","minimum":0},"previous_page":{"type":"string","format":"uri","nullable":true,"description":"URL completa da página anterior (null se for a primeira página)"},"next_page":{"type":"string","format":"uri","nullable":true,"description":"URL completa da próxima página (null se for a última página)"}}}}}}
```

## The ProdutosPagination object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"ProdutosPagination":{"type":"object","description":"Paginação específica do endpoint de produtos (baseado no index.json.jbuilder real)","properties":{"total":{"type":"integer","description":"Total de registros encontrados (total_entries)","minimum":0},"previous_page":{"type":"string","format":"uri","nullable":true,"description":"URL completa da página anterior (null se for a primeira página)"},"next_page":{"type":"string","format":"uri","nullable":true,"description":"URL completa da próxima página (null se for a última página)"}}}}}}
```

## The Address object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"Address":{"type":"object","description":"Endereço completo brasileiro com validação de CEP","properties":{"logradouro":{"type":"string","description":"Nome da rua, avenida, etc.","maxLength":255},"numero":{"type":"string","description":"Número do endereço","maxLength":10},"complemento":{"type":"string","description":"Complemento (apartamento, sala, etc.)","maxLength":100},"bairro":{"type":"string","description":"Nome do bairro","maxLength":100},"cidade":{"type":"string","description":"Nome da cidade","maxLength":100},"uf":{"type":"string","description":"Sigla do estado (2 caracteres)","minLength":2,"maxLength":2,"pattern":"^[A-Z]{2}$"},"cep":{"type":"string","description":"CEP no formato 12345-678","pattern":"^\\d{5}-\\d{3}$"},"ibge_codigo":{"type":"string","description":"Código IBGE da cidade"}},"required":["logradouro","cidade","uf","cep"]}}}}
```

## The Token object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"Token":{"type":"object","description":"Token JWT de autenticação","properties":{"token":{"type":"string","description":"Token JWT de acesso"},"refresh_token":{"type":"string","description":"Token para renovação"},"expires_in":{"type":"integer","description":"Tempo de expiração em segundos (24h)"},"token_type":{"type":"string","description":"Tipo do token"}},"required":["token","expires_in"]}}}}
```

## The Stakeholder object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"Stakeholder":{"type":"object","description":"Stakeholder - Cliente, fornecedor ou transportadora (baseado na view JBuilder real)","properties":{"id":{"type":"string","description":"UUID do stakeholder (retornado como id na API)"},"razao_social":{"type":"string","description":"Razão social ou nome completo","maxLength":255},"nome_fantasia":{"type":"string","description":"Nome fantasia da empresa","maxLength":255},"cnpj":{"type":"string","description":"CPF (11 dígitos) ou CNPJ (14 dígitos) do stakeholder - apenas números, sem formatação. Nota: Na entrada (POST) usar o campo \"numero_do_documento\", na resposta retorna como \"cnpj\"","pattern":"^\\d{11}(\\d{3})?$"},"inscricao_estadual":{"type":"string","description":"Inscrição estadual"},"tipos":{"type":"array","items":{"type":"string"},"description":"Array com tipos de stakeholder","enum":[["cliente"],["fornecedor"],["transportadora"],["cliente","fornecedor"]]},"indicador_ie":{"type":"integer","description":"Código do indicador de IE"},"inscricao_suframa":{"type":"string","description":"Inscrição SUFRAMA"},"cep":{"type":"string","description":"CEP do stakeholder"},"endereco":{"type":"string","description":"Logradouro/endereço"},"numero":{"type":"string","description":"Número do endereço"},"complemento":{"type":"string","description":"Complemento do endereço"},"bairro":{"type":"string","description":"Bairro"},"municipio":{"type":"string","description":"Nome do município"},"uf":{"type":"string","description":"Nome da UF"},"contatos":{"type":"array","description":"Array de contatos do stakeholder (apenas se existirem)","items":{"type":"object","properties":{"id":{"type":"integer"},"nome":{"type":"string"},"email":{"type":"string"},"cargo":{"type":"string"},"ddi":{"type":"string"},"ddd":{"type":"string"},"telefone":{"type":"string"},"principal":{"type":"boolean"}}}}},"required":["id","razao_social","cnpj","tipos"]}}}}
```

## The Produto object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"Produto":{"type":"object","description":"Produto completo (baseado na view JBuilder real)","properties":{"id":{"type":"integer","description":"ID único do produto"},"codigo":{"type":"string","description":"Código interno do produto"},"descricao":{"type":"string","description":"Descrição do produto"},"informacoes_complementares":{"type":"string","description":"Informações complementares"},"principal_modelo_ecommerce":{"type":"boolean","description":"Se é o modelo principal para e-commerce"},"codigo_ecommerce":{"type":"string","description":"Código específico para e-commerce"},"titulo_ecommerce":{"type":"string","description":"Título para e-commerce"},"descricao_ecommerce":{"type":"string","description":"Descrição específica para e-commerce"},"marca":{"type":"string","description":"Marca do produto"},"modelo":{"type":"string","description":"Modelo do produto"},"nome_fabricante":{"type":"string","description":"Nome do fabricante"},"observacao_interna":{"type":"string","description":"Observação interna"},"peso_liquido":{"type":"number","format":"decimal","description":"Peso líquido total"},"peso_liquido_unitario":{"type":"number","format":"decimal","description":"Peso líquido unitário"},"peso_bruto":{"type":"number","format":"decimal","description":"Peso bruto total"},"peso_bruto_unitario":{"type":"number","format":"decimal","description":"Peso bruto unitário"},"pu":{"type":"number","format":"decimal","description":"Preço unitário de entrada (arredondado para 4 casas)"},"pu_saida":{"type":"number","format":"decimal","description":"Preço unitário de saída/venda"},"pu_saida_com_ipi":{"type":"number","format":"decimal","description":"Preço de saída com IPI incluído"},"valor_ipi":{"type":"number","format":"decimal","description":"Valor do IPI"},"aliquota_ipi":{"type":"number","format":"decimal","description":"Alíquota de IPI (percentual arredondado para 2 casas)"},"composicao_de_preco_de_venda":{"type":"boolean","description":"Composição de preço de venda"},"qtde":{"type":"number","format":"decimal","description":"Quantidade atual em estoque"},"qtde_comprometida":{"type":"number","format":"decimal","description":"Quantidade comprometida"},"qtde_armazenada":{"type":"number","format":"decimal","description":"Quantidade armazenada"},"gtin":{"type":"string","description":"Código de barras GTIN"},"codigo_de_barras_interno":{"type":"string","description":"Código de barras interno"},"ncm":{"type":"string","description":"Código NCM (classificacao_fiscal.classificacao)"},"unidade_de_medida":{"type":"string","description":"Código da unidade de medida"},"ativo":{"type":"boolean","description":"Se o produto está ativo (método ativo?)"},"ultima_modificacao":{"type":"string","format":"datetime","description":"Data da última modificação"},"tags":{"type":"array","items":{"type":"string"},"description":"Tags customizadas do produto"},"altura":{"type":"number","format":"decimal","description":"Altura do produto"},"comprimento":{"type":"number","format":"decimal","description":"Comprimento do produto"},"largura":{"type":"number","format":"decimal","description":"Largura do produto"},"imagem_principal":{"type":"string","format":"uri","description":"URL da imagem principal"},"imagens":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"url":{"type":"string","format":"uri"},"principal":{"type":"boolean"}}}},"categoria":{"type":"object","nullable":true,"properties":{"id":{"type":"integer"},"nome":{"type":"string"}}},"subcategoria":{"type":"object","nullable":true,"properties":{"id":{"type":"integer"},"nome":{"type":"string"},"nome_com_categoria":{"type":"string"}}},"propriedades":{"type":"array","items":{"type":"object","properties":{"propriedade":{"type":"string"},"valor":{"type":"string"}}}},"tabelas_de_vendas":{"type":"array","items":{"type":"object","properties":{"codigo":{"type":"string"},"descricao":{"type":"string"},"pu_calculado":{"type":"number","format":"decimal"}}}}},"required":["id","codigo","descricao","ativo"]}}}}
```

## The Recebimento object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"Recebimento":{"type":"object","description":"Conta a receber completa com relacionamentos","properties":{"id":{"type":"integer","description":"ID único da conta a receber"},"numero":{"type":"string","description":"Número identificador da conta","maxLength":50},"stakeholder":{"$ref":"#/components/schemas/Stakeholder"},"valor_original":{"type":"number","format":"decimal","description":"Valor original da conta","minimum":0},"valor_pago":{"type":"number","format":"decimal","description":"Valor já pago da conta","minimum":0},"valor_em_aberto":{"type":"number","format":"decimal","description":"Valor ainda em aberto","minimum":0},"data_vencimento":{"type":"string","format":"date","description":"Data de vencimento"},"data_emissao":{"type":"string","format":"date","description":"Data de emissão"},"status":{"type":"string","enum":["em_aberto","pago_parcial","pago_total","vencido","cancelado"],"description":"Status atual da conta"},"dias_atraso":{"type":"integer","description":"Dias em atraso (se vencido)","minimum":0},"plano_conta":{"type":"string","description":"Código do plano de contas","maxLength":20},"centro_custo":{"type":"string","description":"Centro de custo vinculado","maxLength":50},"observacoes":{"type":"string","description":"Observações sobre a conta","maxLength":1000},"tags":{"type":"array","items":{"type":"string"},"description":"Tags para categorização"}},"required":["numero","valor_original","data_vencimento","status"]},"Stakeholder":{"type":"object","description":"Stakeholder - Cliente, fornecedor ou transportadora (baseado na view JBuilder real)","properties":{"id":{"type":"string","description":"UUID do stakeholder (retornado como id na API)"},"razao_social":{"type":"string","description":"Razão social ou nome completo","maxLength":255},"nome_fantasia":{"type":"string","description":"Nome fantasia da empresa","maxLength":255},"cnpj":{"type":"string","description":"CPF (11 dígitos) ou CNPJ (14 dígitos) do stakeholder - apenas números, sem formatação. Nota: Na entrada (POST) usar o campo \"numero_do_documento\", na resposta retorna como \"cnpj\"","pattern":"^\\d{11}(\\d{3})?$"},"inscricao_estadual":{"type":"string","description":"Inscrição estadual"},"tipos":{"type":"array","items":{"type":"string"},"description":"Array com tipos de stakeholder","enum":[["cliente"],["fornecedor"],["transportadora"],["cliente","fornecedor"]]},"indicador_ie":{"type":"integer","description":"Código do indicador de IE"},"inscricao_suframa":{"type":"string","description":"Inscrição SUFRAMA"},"cep":{"type":"string","description":"CEP do stakeholder"},"endereco":{"type":"string","description":"Logradouro/endereço"},"numero":{"type":"string","description":"Número do endereço"},"complemento":{"type":"string","description":"Complemento do endereço"},"bairro":{"type":"string","description":"Bairro"},"municipio":{"type":"string","description":"Nome do município"},"uf":{"type":"string","description":"Nome da UF"},"contatos":{"type":"array","description":"Array de contatos do stakeholder (apenas se existirem)","items":{"type":"object","properties":{"id":{"type":"integer"},"nome":{"type":"string"},"email":{"type":"string"},"cargo":{"type":"string"},"ddi":{"type":"string"},"ddd":{"type":"string"},"telefone":{"type":"string"},"principal":{"type":"boolean"}}}}},"required":["id","razao_social","cnpj","tipos"]}}}}
```

## The Pagamento object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"Pagamento":{"type":"object","description":"Conta a pagar completa com relacionamentos","properties":{"id":{"type":"integer","description":"ID único da conta a pagar"},"numero":{"type":"string","description":"Número identificador da conta","maxLength":50},"fornecedor":{"$ref":"#/components/schemas/Stakeholder"},"valor_original":{"type":"number","format":"decimal","description":"Valor original da conta","minimum":0},"valor_pago":{"type":"number","format":"decimal","description":"Valor já pago da conta","minimum":0},"valor_em_aberto":{"type":"number","format":"decimal","description":"Valor ainda em aberto","minimum":0},"data_vencimento":{"type":"string","format":"date","description":"Data de vencimento"},"data_emissao":{"type":"string","format":"date","description":"Data de emissão"},"status":{"type":"string","enum":["pendente","aprovado","pago_parcial","pago_total","vencido","cancelado"],"description":"Status atual da conta"},"forma_pagamento":{"$ref":"#/components/schemas/FormaPagamento"},"conta_bancaria":{"$ref":"#/components/schemas/ContaBancaria"},"centro_custo":{"type":"string","description":"Centro de custo vinculado","maxLength":50},"categoria":{"type":"string","description":"Categoria da despesa","maxLength":100}},"required":["numero","fornecedor","valor_original","data_vencimento","status"]},"Stakeholder":{"type":"object","description":"Stakeholder - Cliente, fornecedor ou transportadora (baseado na view JBuilder real)","properties":{"id":{"type":"string","description":"UUID do stakeholder (retornado como id na API)"},"razao_social":{"type":"string","description":"Razão social ou nome completo","maxLength":255},"nome_fantasia":{"type":"string","description":"Nome fantasia da empresa","maxLength":255},"cnpj":{"type":"string","description":"CPF (11 dígitos) ou CNPJ (14 dígitos) do stakeholder - apenas números, sem formatação. Nota: Na entrada (POST) usar o campo \"numero_do_documento\", na resposta retorna como \"cnpj\"","pattern":"^\\d{11}(\\d{3})?$"},"inscricao_estadual":{"type":"string","description":"Inscrição estadual"},"tipos":{"type":"array","items":{"type":"string"},"description":"Array com tipos de stakeholder","enum":[["cliente"],["fornecedor"],["transportadora"],["cliente","fornecedor"]]},"indicador_ie":{"type":"integer","description":"Código do indicador de IE"},"inscricao_suframa":{"type":"string","description":"Inscrição SUFRAMA"},"cep":{"type":"string","description":"CEP do stakeholder"},"endereco":{"type":"string","description":"Logradouro/endereço"},"numero":{"type":"string","description":"Número do endereço"},"complemento":{"type":"string","description":"Complemento do endereço"},"bairro":{"type":"string","description":"Bairro"},"municipio":{"type":"string","description":"Nome do município"},"uf":{"type":"string","description":"Nome da UF"},"contatos":{"type":"array","description":"Array de contatos do stakeholder (apenas se existirem)","items":{"type":"object","properties":{"id":{"type":"integer"},"nome":{"type":"string"},"email":{"type":"string"},"cargo":{"type":"string"},"ddi":{"type":"string"},"ddd":{"type":"string"},"telefone":{"type":"string"},"principal":{"type":"boolean"}}}}},"required":["id","razao_social","cnpj","tipos"]},"FormaPagamento":{"type":"integer","description":"Códigos reais de formas de pagamento (baseado no model Documento)","enum":[1,2,3,4,5,6,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,99]},"ContaBancaria":{"type":"object","description":"Dados reais da conta corrente (baseado na view JBuilder real)","properties":{"codigo_conta_corrente":{"type":"string","description":"UUID da conta corrente (campo real retornado)"},"numero_banco":{"type":"string","description":"Código do banco (3 dígitos)"},"nome_banco":{"type":"string","description":"Nome do banco"},"descricao":{"type":"string","description":"Descrição da conta corrente"},"agencia":{"type":"string","description":"Agência com dígito verificador (método agencia_com_digito)"},"conta_corrente":{"type":"string","description":"Conta corrente com dígito verificador (método conta_corrente_com_digito)"},"emite_boleto_pjbank":{"type":"boolean","description":"Se a conta pode emitir boletos via PJBank (campo real retornado)"},"ativa":{"type":"boolean","description":"Se a conta está ativa para movimentação"}},"required":["codigo_conta_corrente","numero_banco","nome_banco","ativa"]}}}}
```

## The ContaBancaria object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"ContaBancaria":{"type":"object","description":"Dados reais da conta corrente (baseado na view JBuilder real)","properties":{"codigo_conta_corrente":{"type":"string","description":"UUID da conta corrente (campo real retornado)"},"numero_banco":{"type":"string","description":"Código do banco (3 dígitos)"},"nome_banco":{"type":"string","description":"Nome do banco"},"descricao":{"type":"string","description":"Descrição da conta corrente"},"agencia":{"type":"string","description":"Agência com dígito verificador (método agencia_com_digito)"},"conta_corrente":{"type":"string","description":"Conta corrente com dígito verificador (método conta_corrente_com_digito)"},"emite_boleto_pjbank":{"type":"boolean","description":"Se a conta pode emitir boletos via PJBank (campo real retornado)"},"ativa":{"type":"boolean","description":"Se a conta está ativa para movimentação"}},"required":["codigo_conta_corrente","numero_banco","nome_banco","ativa"]}}}}
```

## The ModalidadeEmpresa object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"ModalidadeEmpresa":{"type":"integer","description":"Modalidade fiscal da empresa","enum":[1,2,3,4]}}}}
```

## The TipoEstabelecimento object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"TipoEstabelecimento":{"type":"integer","description":"Tipo de estabelecimento comercial","enum":[1,2,3]}}}}
```

## The CSOSN object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"CSOSN":{"type":"string","description":"Código de Situação da Operação - Simples Nacional","enum":["103","300","400","900"]}}}}
```

## The ModalidadeFrete object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"ModalidadeFrete":{"type":"integer","description":"Modalidade de frete para transporte de mercadorias","enum":[0,1,2,3,4,9]}}}}
```

## The FormaPagamento object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"FormaPagamento":{"type":"integer","description":"Códigos reais de formas de pagamento (baseado no model Documento)","enum":[1,2,3,4,5,6,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,99]}}}}
```

## The OrigemProduto object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"OrigemProduto":{"type":"integer","description":"Origem do produto para fins fiscais","enum":[0,1,2,3,4,5,6,7,8]}}}}
```

## The StatusNotaFiscal object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"StatusNotaFiscal":{"type":"string","description":"Status reais de uma NF-e (códigos de 1 letra do model NotaFiscalConstantes)","enum":["A","C","D","CF","P","F","N","T","R","DC"]}}}}
```

## The NotaFiscalCompleta object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"NotaFiscalCompleta":{"type":"object","description":"Nota fiscal eletrônica completa","properties":{"id":{"type":"integer","description":"ID único da NF-e"},"numero":{"type":"string","description":"Número da nota fiscal"},"serie":{"type":"string","description":"Série da nota fiscal"},"chave_acesso":{"type":"string","description":"Chave de acesso da NF-e (44 dígitos)","pattern":"^\\d{44}$"},"status":{"$ref":"#/components/schemas/StatusNotaFiscal"},"tipo_operacao":{"type":"string","enum":["entrada","saida"],"description":"Tipo da operação"},"data_emissao":{"type":"string","format":"datetime","description":"Data e hora de emissão"},"destinatario":{"$ref":"#/components/schemas/Stakeholder"},"valores":{"type":"object","properties":{"valor_produtos":{"type":"number","format":"decimal","description":"Valor total dos produtos"},"valor_frete":{"type":"number","format":"decimal","description":"Valor do frete"},"valor_seguro":{"type":"number","format":"decimal","description":"Valor do seguro"},"valor_desconto":{"type":"number","format":"decimal","description":"Valor do desconto"},"valor_total":{"type":"number","format":"decimal","description":"Valor total da nota"},"valor_icms":{"type":"number","format":"decimal","description":"Valor do ICMS"},"valor_ipi":{"type":"number","format":"decimal","description":"Valor do IPI"}}},"items":{"type":"array","items":{"type":"object","properties":{"numero_item":{"type":"integer","description":"Número sequencial do item"},"produto":{"$ref":"#/components/schemas/ProdutoCompleto"},"quantidade":{"type":"number","format":"decimal","description":"Quantidade do item"},"valor_unitario":{"type":"number","format":"decimal","description":"Valor unitário"},"valor_total":{"type":"number","format":"decimal","description":"Valor total do item"},"cfop":{"type":"string","description":"CFOP da operação","pattern":"^\\d{4}$"}}}}},"required":["numero","serie","status","tipo_operacao","data_emissao","destinatario","valores"]},"StatusNotaFiscal":{"type":"string","description":"Status reais de uma NF-e (códigos de 1 letra do model NotaFiscalConstantes)","enum":["A","C","D","CF","P","F","N","T","R","DC"]},"Stakeholder":{"type":"object","description":"Stakeholder - Cliente, fornecedor ou transportadora (baseado na view JBuilder real)","properties":{"id":{"type":"string","description":"UUID do stakeholder (retornado como id na API)"},"razao_social":{"type":"string","description":"Razão social ou nome completo","maxLength":255},"nome_fantasia":{"type":"string","description":"Nome fantasia da empresa","maxLength":255},"cnpj":{"type":"string","description":"CPF (11 dígitos) ou CNPJ (14 dígitos) do stakeholder - apenas números, sem formatação. Nota: Na entrada (POST) usar o campo \"numero_do_documento\", na resposta retorna como \"cnpj\"","pattern":"^\\d{11}(\\d{3})?$"},"inscricao_estadual":{"type":"string","description":"Inscrição estadual"},"tipos":{"type":"array","items":{"type":"string"},"description":"Array com tipos de stakeholder","enum":[["cliente"],["fornecedor"],["transportadora"],["cliente","fornecedor"]]},"indicador_ie":{"type":"integer","description":"Código do indicador de IE"},"inscricao_suframa":{"type":"string","description":"Inscrição SUFRAMA"},"cep":{"type":"string","description":"CEP do stakeholder"},"endereco":{"type":"string","description":"Logradouro/endereço"},"numero":{"type":"string","description":"Número do endereço"},"complemento":{"type":"string","description":"Complemento do endereço"},"bairro":{"type":"string","description":"Bairro"},"municipio":{"type":"string","description":"Nome do município"},"uf":{"type":"string","description":"Nome da UF"},"contatos":{"type":"array","description":"Array de contatos do stakeholder (apenas se existirem)","items":{"type":"object","properties":{"id":{"type":"integer"},"nome":{"type":"string"},"email":{"type":"string"},"cargo":{"type":"string"},"ddi":{"type":"string"},"ddd":{"type":"string"},"telefone":{"type":"string"},"principal":{"type":"boolean"}}}}},"required":["id","razao_social","cnpj","tipos"]},"ProdutoCompleto":{"type":"object","description":"Produto completo com informações fiscais e de estoque","allOf":[{"$ref":"#/components/schemas/Produto"},{"type":"object","properties":{"ncm":{"type":"string","description":"Código NCM (8 dígitos)","pattern":"^\\d{8}$"},"cest":{"type":"string","description":"Código CEST (7 dígitos)","pattern":"^\\d{7}$"},"origem":{"$ref":"#/components/schemas/OrigemProduto"},"tributacao":{"type":"object","properties":{"cst_icms":{"type":"string","description":"CST do ICMS"},"cst_pis":{"type":"string","description":"CST do PIS"},"cst_cofins":{"type":"string","description":"CST da COFINS"},"aliquota_icms":{"type":"number","format":"decimal","description":"Alíquota do ICMS (%)"}}},"estoque":{"type":"object","properties":{"quantidade_atual":{"type":"number","format":"decimal","description":"Quantidade atual em estoque"},"quantidade_minima":{"type":"number","format":"decimal","description":"Estoque mínimo"},"localizacao":{"type":"string","description":"Localização no estoque"},"custo_medio":{"type":"number","format":"decimal","description":"Custo médio do produto"}}},"fornecedor_padrao":{"$ref":"#/components/schemas/Stakeholder"}}}]},"Produto":{"type":"object","description":"Produto completo (baseado na view JBuilder real)","properties":{"id":{"type":"integer","description":"ID único do produto"},"codigo":{"type":"string","description":"Código interno do produto"},"descricao":{"type":"string","description":"Descrição do produto"},"informacoes_complementares":{"type":"string","description":"Informações complementares"},"principal_modelo_ecommerce":{"type":"boolean","description":"Se é o modelo principal para e-commerce"},"codigo_ecommerce":{"type":"string","description":"Código específico para e-commerce"},"titulo_ecommerce":{"type":"string","description":"Título para e-commerce"},"descricao_ecommerce":{"type":"string","description":"Descrição específica para e-commerce"},"marca":{"type":"string","description":"Marca do produto"},"modelo":{"type":"string","description":"Modelo do produto"},"nome_fabricante":{"type":"string","description":"Nome do fabricante"},"observacao_interna":{"type":"string","description":"Observação interna"},"peso_liquido":{"type":"number","format":"decimal","description":"Peso líquido total"},"peso_liquido_unitario":{"type":"number","format":"decimal","description":"Peso líquido unitário"},"peso_bruto":{"type":"number","format":"decimal","description":"Peso bruto total"},"peso_bruto_unitario":{"type":"number","format":"decimal","description":"Peso bruto unitário"},"pu":{"type":"number","format":"decimal","description":"Preço unitário de entrada (arredondado para 4 casas)"},"pu_saida":{"type":"number","format":"decimal","description":"Preço unitário de saída/venda"},"pu_saida_com_ipi":{"type":"number","format":"decimal","description":"Preço de saída com IPI incluído"},"valor_ipi":{"type":"number","format":"decimal","description":"Valor do IPI"},"aliquota_ipi":{"type":"number","format":"decimal","description":"Alíquota de IPI (percentual arredondado para 2 casas)"},"composicao_de_preco_de_venda":{"type":"boolean","description":"Composição de preço de venda"},"qtde":{"type":"number","format":"decimal","description":"Quantidade atual em estoque"},"qtde_comprometida":{"type":"number","format":"decimal","description":"Quantidade comprometida"},"qtde_armazenada":{"type":"number","format":"decimal","description":"Quantidade armazenada"},"gtin":{"type":"string","description":"Código de barras GTIN"},"codigo_de_barras_interno":{"type":"string","description":"Código de barras interno"},"ncm":{"type":"string","description":"Código NCM (classificacao_fiscal.classificacao)"},"unidade_de_medida":{"type":"string","description":"Código da unidade de medida"},"ativo":{"type":"boolean","description":"Se o produto está ativo (método ativo?)"},"ultima_modificacao":{"type":"string","format":"datetime","description":"Data da última modificação"},"tags":{"type":"array","items":{"type":"string"},"description":"Tags customizadas do produto"},"altura":{"type":"number","format":"decimal","description":"Altura do produto"},"comprimento":{"type":"number","format":"decimal","description":"Comprimento do produto"},"largura":{"type":"number","format":"decimal","description":"Largura do produto"},"imagem_principal":{"type":"string","format":"uri","description":"URL da imagem principal"},"imagens":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"url":{"type":"string","format":"uri"},"principal":{"type":"boolean"}}}},"categoria":{"type":"object","nullable":true,"properties":{"id":{"type":"integer"},"nome":{"type":"string"}}},"subcategoria":{"type":"object","nullable":true,"properties":{"id":{"type":"integer"},"nome":{"type":"string"},"nome_com_categoria":{"type":"string"}}},"propriedades":{"type":"array","items":{"type":"object","properties":{"propriedade":{"type":"string"},"valor":{"type":"string"}}}},"tabelas_de_vendas":{"type":"array","items":{"type":"object","properties":{"codigo":{"type":"string"},"descricao":{"type":"string"},"pu_calculado":{"type":"number","format":"decimal"}}}}},"required":["id","codigo","descricao","ativo"]},"OrigemProduto":{"type":"integer","description":"Origem do produto para fins fiscais","enum":[0,1,2,3,4,5,6,7,8]}}}}
```

## The ProdutoCompleto object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"ProdutoCompleto":{"type":"object","description":"Produto completo com informações fiscais e de estoque","allOf":[{"$ref":"#/components/schemas/Produto"},{"type":"object","properties":{"ncm":{"type":"string","description":"Código NCM (8 dígitos)","pattern":"^\\d{8}$"},"cest":{"type":"string","description":"Código CEST (7 dígitos)","pattern":"^\\d{7}$"},"origem":{"$ref":"#/components/schemas/OrigemProduto"},"tributacao":{"type":"object","properties":{"cst_icms":{"type":"string","description":"CST do ICMS"},"cst_pis":{"type":"string","description":"CST do PIS"},"cst_cofins":{"type":"string","description":"CST da COFINS"},"aliquota_icms":{"type":"number","format":"decimal","description":"Alíquota do ICMS (%)"}}},"estoque":{"type":"object","properties":{"quantidade_atual":{"type":"number","format":"decimal","description":"Quantidade atual em estoque"},"quantidade_minima":{"type":"number","format":"decimal","description":"Estoque mínimo"},"localizacao":{"type":"string","description":"Localização no estoque"},"custo_medio":{"type":"number","format":"decimal","description":"Custo médio do produto"}}},"fornecedor_padrao":{"$ref":"#/components/schemas/Stakeholder"}}}]},"Produto":{"type":"object","description":"Produto completo (baseado na view JBuilder real)","properties":{"id":{"type":"integer","description":"ID único do produto"},"codigo":{"type":"string","description":"Código interno do produto"},"descricao":{"type":"string","description":"Descrição do produto"},"informacoes_complementares":{"type":"string","description":"Informações complementares"},"principal_modelo_ecommerce":{"type":"boolean","description":"Se é o modelo principal para e-commerce"},"codigo_ecommerce":{"type":"string","description":"Código específico para e-commerce"},"titulo_ecommerce":{"type":"string","description":"Título para e-commerce"},"descricao_ecommerce":{"type":"string","description":"Descrição específica para e-commerce"},"marca":{"type":"string","description":"Marca do produto"},"modelo":{"type":"string","description":"Modelo do produto"},"nome_fabricante":{"type":"string","description":"Nome do fabricante"},"observacao_interna":{"type":"string","description":"Observação interna"},"peso_liquido":{"type":"number","format":"decimal","description":"Peso líquido total"},"peso_liquido_unitario":{"type":"number","format":"decimal","description":"Peso líquido unitário"},"peso_bruto":{"type":"number","format":"decimal","description":"Peso bruto total"},"peso_bruto_unitario":{"type":"number","format":"decimal","description":"Peso bruto unitário"},"pu":{"type":"number","format":"decimal","description":"Preço unitário de entrada (arredondado para 4 casas)"},"pu_saida":{"type":"number","format":"decimal","description":"Preço unitário de saída/venda"},"pu_saida_com_ipi":{"type":"number","format":"decimal","description":"Preço de saída com IPI incluído"},"valor_ipi":{"type":"number","format":"decimal","description":"Valor do IPI"},"aliquota_ipi":{"type":"number","format":"decimal","description":"Alíquota de IPI (percentual arredondado para 2 casas)"},"composicao_de_preco_de_venda":{"type":"boolean","description":"Composição de preço de venda"},"qtde":{"type":"number","format":"decimal","description":"Quantidade atual em estoque"},"qtde_comprometida":{"type":"number","format":"decimal","description":"Quantidade comprometida"},"qtde_armazenada":{"type":"number","format":"decimal","description":"Quantidade armazenada"},"gtin":{"type":"string","description":"Código de barras GTIN"},"codigo_de_barras_interno":{"type":"string","description":"Código de barras interno"},"ncm":{"type":"string","description":"Código NCM (classificacao_fiscal.classificacao)"},"unidade_de_medida":{"type":"string","description":"Código da unidade de medida"},"ativo":{"type":"boolean","description":"Se o produto está ativo (método ativo?)"},"ultima_modificacao":{"type":"string","format":"datetime","description":"Data da última modificação"},"tags":{"type":"array","items":{"type":"string"},"description":"Tags customizadas do produto"},"altura":{"type":"number","format":"decimal","description":"Altura do produto"},"comprimento":{"type":"number","format":"decimal","description":"Comprimento do produto"},"largura":{"type":"number","format":"decimal","description":"Largura do produto"},"imagem_principal":{"type":"string","format":"uri","description":"URL da imagem principal"},"imagens":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"url":{"type":"string","format":"uri"},"principal":{"type":"boolean"}}}},"categoria":{"type":"object","nullable":true,"properties":{"id":{"type":"integer"},"nome":{"type":"string"}}},"subcategoria":{"type":"object","nullable":true,"properties":{"id":{"type":"integer"},"nome":{"type":"string"},"nome_com_categoria":{"type":"string"}}},"propriedades":{"type":"array","items":{"type":"object","properties":{"propriedade":{"type":"string"},"valor":{"type":"string"}}}},"tabelas_de_vendas":{"type":"array","items":{"type":"object","properties":{"codigo":{"type":"string"},"descricao":{"type":"string"},"pu_calculado":{"type":"number","format":"decimal"}}}}},"required":["id","codigo","descricao","ativo"]},"OrigemProduto":{"type":"integer","description":"Origem do produto para fins fiscais","enum":[0,1,2,3,4,5,6,7,8]},"Stakeholder":{"type":"object","description":"Stakeholder - Cliente, fornecedor ou transportadora (baseado na view JBuilder real)","properties":{"id":{"type":"string","description":"UUID do stakeholder (retornado como id na API)"},"razao_social":{"type":"string","description":"Razão social ou nome completo","maxLength":255},"nome_fantasia":{"type":"string","description":"Nome fantasia da empresa","maxLength":255},"cnpj":{"type":"string","description":"CPF (11 dígitos) ou CNPJ (14 dígitos) do stakeholder - apenas números, sem formatação. Nota: Na entrada (POST) usar o campo \"numero_do_documento\", na resposta retorna como \"cnpj\"","pattern":"^\\d{11}(\\d{3})?$"},"inscricao_estadual":{"type":"string","description":"Inscrição estadual"},"tipos":{"type":"array","items":{"type":"string"},"description":"Array com tipos de stakeholder","enum":[["cliente"],["fornecedor"],["transportadora"],["cliente","fornecedor"]]},"indicador_ie":{"type":"integer","description":"Código do indicador de IE"},"inscricao_suframa":{"type":"string","description":"Inscrição SUFRAMA"},"cep":{"type":"string","description":"CEP do stakeholder"},"endereco":{"type":"string","description":"Logradouro/endereço"},"numero":{"type":"string","description":"Número do endereço"},"complemento":{"type":"string","description":"Complemento do endereço"},"bairro":{"type":"string","description":"Bairro"},"municipio":{"type":"string","description":"Nome do município"},"uf":{"type":"string","description":"Nome da UF"},"contatos":{"type":"array","description":"Array de contatos do stakeholder (apenas se existirem)","items":{"type":"object","properties":{"id":{"type":"integer"},"nome":{"type":"string"},"email":{"type":"string"},"cargo":{"type":"string"},"ddi":{"type":"string"},"ddd":{"type":"string"},"telefone":{"type":"string"},"principal":{"type":"boolean"}}}}},"required":["id","razao_social","cnpj","tipos"]}}}}
```

## The DeclaracaoImportacao object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"DeclaracaoImportacao":{"type":"object","description":"Declaração de Importação (DI)","properties":{"id":{"type":"integer","description":"ID único da DI"},"numero_di":{"type":"string","description":"Número da Declaração de Importação","maxLength":15},"data_registro":{"type":"string","format":"date","description":"Data de registro da DI"},"numero_processo":{"type":"string","description":"Número do processo no sistema","maxLength":50},"importador":{"$ref":"#/components/schemas/Stakeholder"},"pais_origem":{"type":"object","properties":{"codigo":{"type":"string","description":"Código do país (3 letras)","pattern":"^[A-Z]{3}$"},"nome":{"type":"string","description":"Nome do país"}}},"via_transporte":{"type":"string","enum":["maritima","aerea","rodoviaria","ferroviaria"],"description":"Via de transporte utilizada"},"valor_total_usd":{"type":"number","format":"decimal","description":"Valor total em USD"},"impostos":{"type":"object","properties":{"imposto_importacao":{"type":"number","format":"decimal","description":"Valor do Imposto de Importação"},"ipi":{"type":"number","format":"decimal","description":"Valor do IPI"},"pis":{"type":"number","format":"decimal","description":"Valor do PIS"},"cofins":{"type":"number","format":"decimal","description":"Valor da COFINS"}}},"status":{"type":"string","enum":["registrada","desembaracada","entregue","cancelada"],"description":"Status da DI"}},"required":["numero_di","data_registro","importador","pais_origem","valor_total_usd","status"]},"Stakeholder":{"type":"object","description":"Stakeholder - Cliente, fornecedor ou transportadora (baseado na view JBuilder real)","properties":{"id":{"type":"string","description":"UUID do stakeholder (retornado como id na API)"},"razao_social":{"type":"string","description":"Razão social ou nome completo","maxLength":255},"nome_fantasia":{"type":"string","description":"Nome fantasia da empresa","maxLength":255},"cnpj":{"type":"string","description":"CPF (11 dígitos) ou CNPJ (14 dígitos) do stakeholder - apenas números, sem formatação. Nota: Na entrada (POST) usar o campo \"numero_do_documento\", na resposta retorna como \"cnpj\"","pattern":"^\\d{11}(\\d{3})?$"},"inscricao_estadual":{"type":"string","description":"Inscrição estadual"},"tipos":{"type":"array","items":{"type":"string"},"description":"Array com tipos de stakeholder","enum":[["cliente"],["fornecedor"],["transportadora"],["cliente","fornecedor"]]},"indicador_ie":{"type":"integer","description":"Código do indicador de IE"},"inscricao_suframa":{"type":"string","description":"Inscrição SUFRAMA"},"cep":{"type":"string","description":"CEP do stakeholder"},"endereco":{"type":"string","description":"Logradouro/endereço"},"numero":{"type":"string","description":"Número do endereço"},"complemento":{"type":"string","description":"Complemento do endereço"},"bairro":{"type":"string","description":"Bairro"},"municipio":{"type":"string","description":"Nome do município"},"uf":{"type":"string","description":"Nome da UF"},"contatos":{"type":"array","description":"Array de contatos do stakeholder (apenas se existirem)","items":{"type":"object","properties":{"id":{"type":"integer"},"nome":{"type":"string"},"email":{"type":"string"},"cargo":{"type":"string"},"ddi":{"type":"string"},"ddd":{"type":"string"},"telefone":{"type":"string"},"principal":{"type":"boolean"}}}}},"required":["id","razao_social","cnpj","tipos"]}}}}
```

## The WebhookEvent object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"WebhookEvent":{"type":"object","description":"Estrutura padrão de eventos de webhook","properties":{"id":{"type":"string","format":"uuid","description":"ID único do evento"},"event_type":{"type":"string","description":"Tipo do evento","enum":["nfe.status_changed","payment.received","stock.low_inventory","user.created"]},"timestamp":{"type":"string","format":"datetime","description":"Data e hora do evento"},"data":{"type":"object","description":"Dados específicos do evento","additionalProperties":true},"metadata":{"type":"object","properties":{"source":{"type":"string","description":"Origem do evento"},"version":{"type":"string","description":"Versão da API"},"correlation_id":{"type":"string","description":"ID de correlação para rastreamento"}}}},"required":["id","event_type","timestamp","data"]}}}}
```

## The IntegracaoSAP object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"IntegracaoSAP":{"type":"object","description":"Dados de integração com SAP ERP","properties":{"sap_id":{"type":"string","description":"ID do registro no SAP","maxLength":20},"tipo_objeto":{"type":"string","enum":["material","cliente","fornecedor","pedido","nota_fiscal"],"description":"Tipo de objeto SAP"},"ultima_sincronizacao":{"type":"string","format":"datetime","description":"Data da última sincronização"},"status_sync":{"type":"string","enum":["sincronizado","pendente","erro","conflito"],"description":"Status da sincronização"},"detalhes_erro":{"type":"string","description":"Detalhes do erro (se houver)"},"dados_mapeamento":{"type":"object","description":"Mapeamento de campos entre sistemas","additionalProperties":true}},"required":["sap_id","tipo_objeto","status_sync"]}}}}
```

## The PaginationInfo object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"PaginationInfo":{"type":"object","description":"Informações completas de paginação com navegação","allOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"object","properties":{"first_page":{"type":"string","format":"uri","description":"URL da primeira página"},"last_page":{"type":"string","format":"uri","description":"URL da última página"},"next_page":{"type":"string","format":"uri","nullable":true,"description":"URL da próxima página"},"previous_page":{"type":"string","format":"uri","nullable":true,"description":"URL da página anterior"}}}]},"Pagination":{"type":"object","description":"Informações de paginação - Schema genérico (não usado diretamente, ver StakeholdersPagination e ProdutosPagination)","properties":{"total":{"type":"integer","description":"Total de páginas ou registros (varia por endpoint)","minimum":0},"count":{"type":"integer","description":"Contagem de registros (apenas em alguns endpoints)","minimum":0},"previous_page":{"type":"string","format":"uri","nullable":true,"description":"URL completa da página anterior (null se for a primeira página)"},"next_page":{"type":"string","format":"uri","nullable":true,"description":"URL completa da próxima página (null se for a última página)"}}}}}}
```

## The FiltroAvancado object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"FiltroAvancado":{"type":"object","description":"Sistema avançado de filtros para consultas","properties":{"data_inicio":{"type":"string","format":"date","description":"Data inicial do filtro"},"data_fim":{"type":"string","format":"date","description":"Data final do filtro"},"status":{"type":"array","items":{"type":"string"},"description":"Lista de status para filtrar"},"valor_minimo":{"type":"number","format":"decimal","description":"Valor mínimo para filtro"},"valor_maximo":{"type":"number","format":"decimal","description":"Valor máximo para filtro"},"tags":{"type":"array","items":{"type":"string"},"description":"Tags para filtrar"},"busca_textual":{"type":"string","description":"Busca textual em campos relevantes"},"ordenacao":{"type":"object","properties":{"campo":{"type":"string","description":"Campo para ordenação"},"direcao":{"type":"string","enum":["asc","desc"],"description":"Direção da ordenação"}}}}}}}}
```

## The ProcessoEdicaoInput object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"ProcessoEdicaoInput":{"type":"object","description":"Corpo aceito por PATCH /processos/{uuid} (raiz `processo`). Mesmas chaves do POST, todas opcionais: só as chaves enviadas são alteradas.","properties":{"tipo":{"type":"string","enum":["importacao","exportacao","aquisicao"],"description":"Tipo do processo. Obrigatório."},"via":{"type":"string","enum":["maritima","aerea","rodoviaria"],"description":"Via de transporte. Obrigatório."},"modalidade":{"type":"string","enum":["importacao_direta","conta_e_ordem","encomenda"],"description":"Modalidade da importação."},"incoterm":{"type":"string","enum":["EXW","FCA","CPT","CIP","DAP","DPU","DDP","FAS","FOB","CFR","CIF"],"description":"Incoterm da operação."},"codigo":{"type":"string","description":"Código do processo. Quando ausente ou em branco, o servidor gera o próximo código da empresa."},"moeda_codigo_iso":{"type":"string","description":"Sigla ISO da moeda (ex: 'USD', 'BRL'). Resolvida contra o cadastro de moedas — sigla inexistente devolve 422 em /moeda_codigo_iso, sem fallback para BRL."},"cliente_razao_social":{"type":"string","description":"Razão social do cliente (busca parcial entre os clientes da empresa)."},"cliente_documento":{"type":"string","description":"CNPJ/CPF do cliente (busca exata, normalizada). Precede cliente_razao_social quando ambos vêm."},"fornecedor_razao_social":{"type":"string","description":"Razão social do fornecedor (busca parcial entre os fornecedores da empresa)."},"fornecedor_documento":{"type":"string","description":"CNPJ/CPF do fornecedor (busca exata, normalizada). Precede fornecedor_razao_social quando ambos vêm."},"importador_razao_social":{"type":"string","description":"Razão social do importador (busca parcial entre os stakeholders da empresa)."},"importador_documento":{"type":"string","description":"CNPJ/CPF do importador (busca exata, normalizada). Precede importador_razao_social quando ambos vêm."},"despachante_razao_social":{"type":"string","description":"Razão social do despachante aduaneiro (busca parcial entre os despachantes da empresa)."},"despachante_documento":{"type":"string","description":"CNPJ/CPF do despachante aduaneiro (busca exata, normalizada). Precede despachante_razao_social quando ambos vêm."},"agente_carga_razao_social":{"type":"string","description":"Razão social do agente de carga (busca parcial entre os agentes de carga da empresa)."},"agente_carga_documento":{"type":"string","description":"CNPJ/CPF do agente de carga (busca exata, normalizada). Precede agente_carga_razao_social quando ambos vêm."},"pessoa_responsavel_id":{"type":"integer","description":"ID da Pessoa responsável pelo processo, resolvido entre as pessoas da empresa. Atenção: a chave é pessoa_responsavel_id — pessoa_responsavel devolve 422 de campo desconhecido."},"data_pedido":{"type":"string","format":"date","description":"Data do pedido."},"data_purchase_order":{"type":"string","format":"date","description":"Data da Purchase Order (campo legado)."},"data_cambio_antecipacao":{"type":"string","format":"date","description":"Data do câmbio de antecipação."},"data_embarque":{"type":"string","format":"date-time","description":"Data de embarque."},"eta":{"type":"string","format":"date-time","description":"ETA — chegada estimada."},"data_chegada":{"type":"string","format":"date-time","description":"Data de chegada."},"numerario_cambio":{"type":"number","description":"Numerário de câmbio."},"array_custom_tags":{"type":"array","items":{"type":"string"},"description":"Nomes das custom tags a vincular ao processo."},"descricao":{"type":"string","description":"Descrição do processo."},"numero_invoice":{"type":"string","description":"Número da invoice."},"condicao_pagamento":{"type":"string","description":"Condição de pagamento."},"categoria":{"type":"string","description":"Categoria do processo."},"observacao":{"type":"string","description":"Observações."},"outra_referencia":{"type":"string","description":"Outra referência."},"codigo_purchase_order":{"type":"string","description":"Código da Purchase Order (campo legado)."},"campanhia_aerea":{"type":"string","description":"Companhia aérea (grafia da coluna). Prevalece sobre companhia_aerea quando ambas vêm no mesmo payload."},"companhia_aerea":{"type":"string","description":"Companhia aérea (apelido de escrita aceito). Gravado em campanhia_aerea, que é a grafia devolvida na resposta."},"numero_do_voo":{"type":"string","description":"Número do voo."}}}}}}
```

## The CustoDeImportacaoInput object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"schemas":{"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"]}}}}
```

## The CustoDeImportacaoResultado object

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"components":{"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"]}}}}
```
