> 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/09.-movimentacoes-de-estoque.md).

# 09. 🔄 Movimentações De Estoque

**Histórico detalhado de movimentações** Rastreabilidade completa de todas as operações de estoque. **Tipos de movimento:**

* Entradas (compras, ajustes, devoluções)
* Saídas (vendas, transferências, perdas)
* Transferências entre depósitos
* Inventários e acertos de estoque

## Lista movimentações de estoque

> Retorna lista de movimentações de estoque com filtros

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"09. 🔄 Movimentações de Estoque","description":"**Histórico detalhado de movimentações**\nRastreabilidade completa de todas as operações de estoque.\n**Tipos de movimento:**\n- Entradas (compras, ajustes, devoluções)\n- Saídas (vendas, transferências, perdas)\n- Transferências entre depósitos\n- Inventários e acertos de estoque"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}},"schemas":{"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"]}}},"paths":{"/estoque/movimentacoes":{"get":{"summary":"Lista movimentações de estoque","tags":["09. 🔄 Movimentações de Estoque"],"description":"Retorna lista de movimentações de estoque com filtros","parameters":[{"name":"data_inicio","in":"query","schema":{"type":"string","format":"date"},"description":"Data de início da confirmação (AAAA-MM-DD). Data inexistente ou enviada como lista responde 400","required":false},{"name":"data_fim","in":"query","schema":{"type":"string","format":"date"},"description":"Data de fim da confirmação (AAAA-MM-DD), inclusiva. Data inexistente ou enviada como lista responde 400","required":false},{"name":"tipo","in":"query","required":false,"schema":{"type":"integer","enum":[0,1]},"description":"Tipo da movimentação de estoque (0 = saída, 1 = entrada). Outro valor responde 400"},{"name":"motivo","in":"query","required":false,"schema":{"type":"integer","enum":[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17]},"description":"Código do motivo da movimentação de estoque"},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":999999999},"description":"Número da página (10 movimentações por página). Zero, texto ou mais de 9 dígitos responde 400","required":false}],"responses":{"200":{"description":"Lista de movimentações","content":{"application/json":{"schema":{"type":"object","properties":{"movimentacoes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","description":"ID da movimentação"},"numero_cupom":{"type":"string","nullable":true,"description":"Número do cupom"},"numero_nota_fiscal":{"type":"string","nullable":true,"description":"Número da nota fiscal"},"quantidade":{"type":"string","description":"Quantidade movimentada"},"preco_unitario":{"type":"number","format":"float","description":"Preço unitário"},"tipo":{"type":"string","description":"Tipo da movimentação (Entrada/Saída)"},"status":{"type":"string","description":"Status da movimentação"},"dthr_confirmacao":{"type":"string","format":"datetime","nullable":true,"description":"Data e hora da confirmação"},"observacao":{"type":"string","nullable":true,"description":"Observações"},"custo_medio":{"type":"number","format":"float","nullable":true,"description":"Custo médio unitário do produto gravado na movimentação; a API não o recalcula na consulta, mas o recálculo de estoque do produto pode atualizá-lo. Saída: custo médio do produto no momento da saída (custo unitário da venda; igual à coluna 'PU Entrada' do relatório de movimentação em Excel). Entrada: custo médio registrado na confirmação da entrada; o preço pago na entrada está em `preco_unitario`. 0 pode significar sem custo gravado (movimentação pendente, de armazenagem ou registro antigo) e nunca é substituído pelo custo atual do produto. null quando o usuário autenticado não tem a permissão 'Permitir visualização de PU de entrada'."},"custo_total":{"type":"number","format":"float","nullable":true,"description":"Custo total da movimentação com a mesma regra da coluna 'Custo' do relatório de movimentação em Excel: saída = `custo_medio` × quantidade; entrada = `preco_unitario` × quantidade; ajuste com preço zero = 0. 0 também quando não há custo gravado. null quando o usuário autenticado não tem a permissão 'Permitir visualização de PU de entrada'."},"produto":{"type":"object","properties":{"id":{"type":"integer","description":"ID do produto"},"codigo":{"type":"string","description":"Código do produto"},"descricao":{"type":"string","description":"Descrição do produto"},"preco_unitario":{"type":"string","description":"Preço unitário do produto"},"quantidade":{"type":"string","description":"Quantidade em estoque"}}},"item_nota_fiscal":{"type":"object","description":"Item da NF-e que gerou a movimentação, com os mesmos campos e valores do item em `GET /nfes/{id}`. Todas as chaves saem null quando a movimentação não veio de um item de NF-e (por exemplo, movimentação manual) ou quando o vínculo é só com a nota, sem o item. Os campos numéricos do item saem null quando a nota é de entrada e o usuário autenticado não tem a permissão 'Permitir visualização de PU de entrada'. Identificação e códigos continuam preenchidos, e valor_unitario, valor_total e preco_unitario não mudam.","properties":{"numero_item":{"type":"integer","nullable":true,"description":"Número do item na NF-e, igual ao nItem do XML."},"ncm":{"type":"string","nullable":true,"description":"NCM do item, como sai no XML."},"chave_acesso_nfe":{"type":"string","nullable":true,"description":"Chave de acesso da NF-e do item. null enquanto a nota não tem chave."},"cfop":{"type":"string","nullable":true,"description":"CFOP do item (tag CFOP). Sai o código registrado no item mesmo quando o XML não emite o grupo. null quando o item não tem o código."},"cst_icms":{"type":"string","nullable":true,"description":"CST do ICMS (tag CST do grupo ICMS). null para emitente do Simples Nacional, que usa csosn. Sai o código registrado no item mesmo quando o XML não emite o grupo. null quando o item não tem o código."},"csosn":{"type":"string","nullable":true,"description":"CSOSN do ICMS (tag CSOSN do grupo ICMSSN). Só para emitente do Simples Nacional; null nos demais, que usam cst_icms. Sai o código registrado no item mesmo quando o XML não emite o grupo. null quando o item não tem o código."},"cst_ipi":{"type":"string","nullable":true,"description":"CST do IPI (tag CST do grupo IPI). Sai o código registrado no item mesmo quando o XML não emite o grupo. null quando o item não tem o código."},"cst_pis":{"type":"string","nullable":true,"description":"CST do PIS (tag CST do grupo PIS). Sai o código registrado no item mesmo quando o XML não emite o grupo. null quando o item não tem o código."},"cst_cofins":{"type":"string","nullable":true,"description":"CST da COFINS (tag CST do grupo COFINS). Sai o código registrado no item mesmo quando o XML não emite o grupo. null quando o item não tem o código."},"cst_ibs_cbs":{"type":"string","nullable":true,"description":"CST do IBS e da CBS (tag CST do grupo IBSCBS). Sai o código registrado no item mesmo quando o XML não emite o grupo. null quando o item não tem o código."},"classificacao_tributaria_ibs_cbs":{"type":"string","nullable":true,"description":"Classificação tributária do IBS e da CBS (tag cClassTrib). Sai o código registrado no item mesmo quando o XML não emite o grupo. null quando o item não tem o código."},"valor_produto":{"type":"number","nullable":true,"description":"Valor total bruto do item (vProd).","format":"float"},"valor_frete":{"type":"number","nullable":true,"description":"Frete do item (vFrete). 0 quando o XML não traz a tag.","format":"float"},"valor_seguro":{"type":"number","nullable":true,"description":"Seguro do item (vSeg). 0 quando o XML não traz a tag.","format":"float"},"valor_outras_despesas":{"type":"number","nullable":true,"description":"Outras despesas acessórias do item (vOutro), que somam as despesas aduaneiras. 0 quando o XML não traz a tag.","format":"float"},"base_ii":{"type":"number","nullable":true,"description":"Base de cálculo do II. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"aliquota_ii":{"type":"number","nullable":true,"description":"Alíquota do II (%), do cadastro do item com 2 casas: o XML não tem pII.","format":"float"},"valor_ii":{"type":"number","nullable":true,"description":"Valor do II. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"base_ipi":{"type":"number","nullable":true,"description":"Base de cálculo do IPI. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"aliquota_ipi":{"type":"number","nullable":true,"description":"Alíquota do IPI (%). Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"valor_ipi":{"type":"number","nullable":true,"description":"Valor do IPI. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"base_pis":{"type":"number","nullable":true,"description":"Base de cálculo do PIS. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"aliquota_pis":{"type":"number","nullable":true,"description":"Alíquota do PIS (%). Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"valor_pis":{"type":"number","nullable":true,"description":"Valor do PIS. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"base_cofins":{"type":"number","nullable":true,"description":"Base de cálculo do COFINS. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"aliquota_cofins":{"type":"number","nullable":true,"description":"Alíquota do COFINS (%). Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"valor_cofins":{"type":"number","nullable":true,"description":"Valor do COFINS. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"base_icms":{"type":"number","nullable":true,"description":"Base de cálculo do ICMS. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"aliquota_icms":{"type":"number","nullable":true,"description":"Alíquota do ICMS (%). Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"valor_icms":{"type":"number","nullable":true,"description":"Valor do ICMS (vICMS). No CST 51, o valor efetivo, já descontado o diferimento.","format":"float"},"base_icms_st":{"type":"number","nullable":true,"description":"Base de cálculo do ICMS-ST. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"aliquota_icms_st":{"type":"number","nullable":true,"description":"Alíquota do ICMS-ST (pICMSST). Na NF-e 4.00, sem o FCP-ST, que o XML informa em grupo próprio.","format":"float"},"valor_icms_st":{"type":"number","nullable":true,"description":"Valor do ICMS-ST. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"base_fcp":{"type":"number","nullable":true,"description":"Base de cálculo do FCP. Valor registrado no item, formatado como as tags vBCFCP/pFCP/vFCP. Preenchido só quando o item tem alíquota e valor do FCP e a NF-e é 4.00, a mesma condição em que o XML emite o grupo; senão 0. Fora da 4.00 é sempre 0, porque o XML soma o FCP-ST ao ICMS-ST. O despacho por CST não é espelhado: em CST que não emite o grupo, sai o valor registrado. No CST 00 o XML não traz vBCFCP, e base_fcp devolve a base registrada.","format":"float"},"aliquota_fcp":{"type":"number","nullable":true,"description":"Alíquota do FCP (%). Valor registrado no item, formatado como as tags vBCFCP/pFCP/vFCP. Preenchido só quando o item tem alíquota e valor do FCP e a NF-e é 4.00, a mesma condição em que o XML emite o grupo; senão 0. Fora da 4.00 é sempre 0, porque o XML soma o FCP-ST ao ICMS-ST. O despacho por CST não é espelhado: em CST que não emite o grupo, sai o valor registrado.","format":"float"},"valor_fcp":{"type":"number","nullable":true,"description":"Valor do FCP. Valor registrado no item, formatado como as tags vBCFCP/pFCP/vFCP. Preenchido só quando o item tem alíquota e valor do FCP e a NF-e é 4.00, a mesma condição em que o XML emite o grupo; senão 0. Fora da 4.00 é sempre 0, porque o XML soma o FCP-ST ao ICMS-ST. O despacho por CST não é espelhado: em CST que não emite o grupo, sai o valor registrado.","format":"float"},"base_fcp_st":{"type":"number","nullable":true,"description":"Base de cálculo do FCP-ST. Valor registrado no item, formatado como as tags vBCFCPST/pFCPST/vFCPST. Preenchido só quando o item tem alíquota e valor do FCP-ST e a NF-e é 4.00, a mesma condição em que o XML emite o grupo; senão 0. Fora da 4.00 é sempre 0, porque o XML soma o FCP-ST ao ICMS-ST. O despacho por CST não é espelhado: em CST que não emite o grupo, sai o valor registrado.","format":"float"},"aliquota_fcp_st":{"type":"number","nullable":true,"description":"Alíquota do FCP-ST (%). Valor registrado no item, formatado como as tags vBCFCPST/pFCPST/vFCPST. Preenchido só quando o item tem alíquota e valor do FCP-ST e a NF-e é 4.00, a mesma condição em que o XML emite o grupo; senão 0. Fora da 4.00 é sempre 0, porque o XML soma o FCP-ST ao ICMS-ST. O despacho por CST não é espelhado: em CST que não emite o grupo, sai o valor registrado.","format":"float"},"valor_fcp_st":{"type":"number","nullable":true,"description":"Valor do FCP-ST. Valor registrado no item, formatado como as tags vBCFCPST/pFCPST/vFCPST. Preenchido só quando o item tem alíquota e valor do FCP-ST e a NF-e é 4.00, a mesma condição em que o XML emite o grupo; senão 0. Fora da 4.00 é sempre 0, porque o XML soma o FCP-ST ao ICMS-ST. O despacho por CST não é espelhado: em CST que não emite o grupo, sai o valor registrado.","format":"float"},"base_ibs_cbs":{"type":"number","nullable":true,"description":"Base de cálculo do IBS e da CBS (vBC do grupo gIBSCBS).","format":"float"},"aliquota_ibs_uf":{"type":"number","nullable":true,"description":"Alíquota do IBS estadual (pIBSUF).","format":"float"},"valor_ibs_uf":{"type":"number","nullable":true,"description":"Valor do IBS estadual (vIBSUF).","format":"float"},"aliquota_ibs_mun":{"type":"number","nullable":true,"description":"Alíquota do IBS municipal (pIBSMun).","format":"float"},"valor_ibs_mun":{"type":"number","nullable":true,"description":"Valor do IBS municipal (vIBSMun).","format":"float"},"aliquota_cbs":{"type":"number","nullable":true,"description":"Alíquota da CBS (pCBS).","format":"float"},"valor_cbs":{"type":"number","nullable":true,"description":"Valor da CBS (vCBS).","format":"float"}}}}}}}}}}},"400":{"description":"Parâmetro inválido; `errors.fields` traz a mensagem de cada parâmetro recusado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimpleError"}}}},"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"403":{"description":"Pessoa autenticada sem acesso à tela de movimentações de estoque","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```

## Exibe movimentação específica

> Retorna detalhes de uma movimentação específica

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"09. 🔄 Movimentações de Estoque","description":"**Histórico detalhado de movimentações**\nRastreabilidade completa de todas as operações de estoque.\n**Tipos de movimento:**\n- Entradas (compras, ajustes, devoluções)\n- Saídas (vendas, transferências, perdas)\n- Transferências entre depósitos\n- Inventários e acertos de estoque"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}}},"paths":{"/estoque/movimentacoes/{id}":{"get":{"summary":"Exibe movimentação específica","tags":["09. 🔄 Movimentações de Estoque"],"description":"Retorna detalhes de uma movimentação específica","responses":{"200":{"description":"Movimentação encontrada","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"ID da movimentação"},"numero_cupom":{"type":"string","nullable":true,"description":"Número do cupom"},"numero_nota_fiscal":{"type":"string","nullable":true,"description":"Número da nota fiscal"},"quantidade":{"type":"string","description":"Quantidade movimentada"},"preco_unitario":{"type":"number","format":"float","description":"Preço unitário"},"tipo":{"type":"string","description":"Tipo da movimentação (Entrada/Saída)"},"status":{"type":"string","description":"Status da movimentação"},"dthr_confirmacao":{"type":"string","format":"datetime","nullable":true,"description":"Data e hora da confirmação"},"observacao":{"type":"string","nullable":true,"description":"Observações"},"custo_medio":{"type":"number","format":"float","nullable":true,"description":"Custo médio unitário do produto gravado na movimentação; a API não o recalcula na consulta, mas o recálculo de estoque do produto pode atualizá-lo. Saída: custo médio do produto no momento da saída (custo unitário da venda; igual à coluna 'PU Entrada' do relatório de movimentação em Excel). Entrada: custo médio registrado na confirmação da entrada; o preço pago na entrada está em `preco_unitario`. 0 pode significar sem custo gravado (movimentação pendente, de armazenagem ou registro antigo) e nunca é substituído pelo custo atual do produto. null quando o usuário autenticado não tem a permissão 'Permitir visualização de PU de entrada'."},"custo_total":{"type":"number","format":"float","nullable":true,"description":"Custo total da movimentação com a mesma regra da coluna 'Custo' do relatório de movimentação em Excel: saída = `custo_medio` × quantidade; entrada = `preco_unitario` × quantidade; ajuste com preço zero = 0. 0 também quando não há custo gravado. null quando o usuário autenticado não tem a permissão 'Permitir visualização de PU de entrada'."},"produto":{"type":"object","properties":{"id":{"type":"integer","description":"ID do produto"},"codigo":{"type":"string","description":"Código do produto"},"descricao":{"type":"string","description":"Descrição do produto"},"preco_unitario":{"type":"string","description":"Preço unitário do produto"},"quantidade":{"type":"string","description":"Quantidade em estoque"}}},"item_nota_fiscal":{"type":"object","description":"Item da NF-e que gerou a movimentação, com os mesmos campos e valores do item em `GET /nfes/{id}`. Todas as chaves saem null quando a movimentação não veio de um item de NF-e (por exemplo, movimentação manual) ou quando o vínculo é só com a nota, sem o item. Os campos numéricos do item saem null quando a nota é de entrada e o usuário autenticado não tem a permissão 'Permitir visualização de PU de entrada'. Identificação e códigos continuam preenchidos, e valor_unitario, valor_total e preco_unitario não mudam.","properties":{"numero_item":{"type":"integer","nullable":true,"description":"Número do item na NF-e, igual ao nItem do XML."},"ncm":{"type":"string","nullable":true,"description":"NCM do item, como sai no XML."},"chave_acesso_nfe":{"type":"string","nullable":true,"description":"Chave de acesso da NF-e do item. null enquanto a nota não tem chave."},"cfop":{"type":"string","nullable":true,"description":"CFOP do item (tag CFOP). Sai o código registrado no item mesmo quando o XML não emite o grupo. null quando o item não tem o código."},"cst_icms":{"type":"string","nullable":true,"description":"CST do ICMS (tag CST do grupo ICMS). null para emitente do Simples Nacional, que usa csosn. Sai o código registrado no item mesmo quando o XML não emite o grupo. null quando o item não tem o código."},"csosn":{"type":"string","nullable":true,"description":"CSOSN do ICMS (tag CSOSN do grupo ICMSSN). Só para emitente do Simples Nacional; null nos demais, que usam cst_icms. Sai o código registrado no item mesmo quando o XML não emite o grupo. null quando o item não tem o código."},"cst_ipi":{"type":"string","nullable":true,"description":"CST do IPI (tag CST do grupo IPI). Sai o código registrado no item mesmo quando o XML não emite o grupo. null quando o item não tem o código."},"cst_pis":{"type":"string","nullable":true,"description":"CST do PIS (tag CST do grupo PIS). Sai o código registrado no item mesmo quando o XML não emite o grupo. null quando o item não tem o código."},"cst_cofins":{"type":"string","nullable":true,"description":"CST da COFINS (tag CST do grupo COFINS). Sai o código registrado no item mesmo quando o XML não emite o grupo. null quando o item não tem o código."},"cst_ibs_cbs":{"type":"string","nullable":true,"description":"CST do IBS e da CBS (tag CST do grupo IBSCBS). Sai o código registrado no item mesmo quando o XML não emite o grupo. null quando o item não tem o código."},"classificacao_tributaria_ibs_cbs":{"type":"string","nullable":true,"description":"Classificação tributária do IBS e da CBS (tag cClassTrib). Sai o código registrado no item mesmo quando o XML não emite o grupo. null quando o item não tem o código."},"valor_produto":{"type":"number","nullable":true,"description":"Valor total bruto do item (vProd).","format":"float"},"valor_frete":{"type":"number","nullable":true,"description":"Frete do item (vFrete). 0 quando o XML não traz a tag.","format":"float"},"valor_seguro":{"type":"number","nullable":true,"description":"Seguro do item (vSeg). 0 quando o XML não traz a tag.","format":"float"},"valor_outras_despesas":{"type":"number","nullable":true,"description":"Outras despesas acessórias do item (vOutro), que somam as despesas aduaneiras. 0 quando o XML não traz a tag.","format":"float"},"base_ii":{"type":"number","nullable":true,"description":"Base de cálculo do II. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"aliquota_ii":{"type":"number","nullable":true,"description":"Alíquota do II (%), do cadastro do item com 2 casas: o XML não tem pII.","format":"float"},"valor_ii":{"type":"number","nullable":true,"description":"Valor do II. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"base_ipi":{"type":"number","nullable":true,"description":"Base de cálculo do IPI. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"aliquota_ipi":{"type":"number","nullable":true,"description":"Alíquota do IPI (%). Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"valor_ipi":{"type":"number","nullable":true,"description":"Valor do IPI. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"base_pis":{"type":"number","nullable":true,"description":"Base de cálculo do PIS. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"aliquota_pis":{"type":"number","nullable":true,"description":"Alíquota do PIS (%). Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"valor_pis":{"type":"number","nullable":true,"description":"Valor do PIS. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"base_cofins":{"type":"number","nullable":true,"description":"Base de cálculo do COFINS. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"aliquota_cofins":{"type":"number","nullable":true,"description":"Alíquota do COFINS (%). Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"valor_cofins":{"type":"number","nullable":true,"description":"Valor do COFINS. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"base_icms":{"type":"number","nullable":true,"description":"Base de cálculo do ICMS. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"aliquota_icms":{"type":"number","nullable":true,"description":"Alíquota do ICMS (%). Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"valor_icms":{"type":"number","nullable":true,"description":"Valor do ICMS (vICMS). No CST 51, o valor efetivo, já descontado o diferimento.","format":"float"},"base_icms_st":{"type":"number","nullable":true,"description":"Base de cálculo do ICMS-ST. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"aliquota_icms_st":{"type":"number","nullable":true,"description":"Alíquota do ICMS-ST (pICMSST). Na NF-e 4.00, sem o FCP-ST, que o XML informa em grupo próprio.","format":"float"},"valor_icms_st":{"type":"number","nullable":true,"description":"Valor do ICMS-ST. Quando o XML não destaca o tributo (por exemplo, CST isento ou não tributado), devolve o valor registrado no item, que pode ser diferente de 0 e não indica destaque na NF-e.","format":"float"},"base_fcp":{"type":"number","nullable":true,"description":"Base de cálculo do FCP. Valor registrado no item, formatado como as tags vBCFCP/pFCP/vFCP. Preenchido só quando o item tem alíquota e valor do FCP e a NF-e é 4.00, a mesma condição em que o XML emite o grupo; senão 0. Fora da 4.00 é sempre 0, porque o XML soma o FCP-ST ao ICMS-ST. O despacho por CST não é espelhado: em CST que não emite o grupo, sai o valor registrado. No CST 00 o XML não traz vBCFCP, e base_fcp devolve a base registrada.","format":"float"},"aliquota_fcp":{"type":"number","nullable":true,"description":"Alíquota do FCP (%). Valor registrado no item, formatado como as tags vBCFCP/pFCP/vFCP. Preenchido só quando o item tem alíquota e valor do FCP e a NF-e é 4.00, a mesma condição em que o XML emite o grupo; senão 0. Fora da 4.00 é sempre 0, porque o XML soma o FCP-ST ao ICMS-ST. O despacho por CST não é espelhado: em CST que não emite o grupo, sai o valor registrado.","format":"float"},"valor_fcp":{"type":"number","nullable":true,"description":"Valor do FCP. Valor registrado no item, formatado como as tags vBCFCP/pFCP/vFCP. Preenchido só quando o item tem alíquota e valor do FCP e a NF-e é 4.00, a mesma condição em que o XML emite o grupo; senão 0. Fora da 4.00 é sempre 0, porque o XML soma o FCP-ST ao ICMS-ST. O despacho por CST não é espelhado: em CST que não emite o grupo, sai o valor registrado.","format":"float"},"base_fcp_st":{"type":"number","nullable":true,"description":"Base de cálculo do FCP-ST. Valor registrado no item, formatado como as tags vBCFCPST/pFCPST/vFCPST. Preenchido só quando o item tem alíquota e valor do FCP-ST e a NF-e é 4.00, a mesma condição em que o XML emite o grupo; senão 0. Fora da 4.00 é sempre 0, porque o XML soma o FCP-ST ao ICMS-ST. O despacho por CST não é espelhado: em CST que não emite o grupo, sai o valor registrado.","format":"float"},"aliquota_fcp_st":{"type":"number","nullable":true,"description":"Alíquota do FCP-ST (%). Valor registrado no item, formatado como as tags vBCFCPST/pFCPST/vFCPST. Preenchido só quando o item tem alíquota e valor do FCP-ST e a NF-e é 4.00, a mesma condição em que o XML emite o grupo; senão 0. Fora da 4.00 é sempre 0, porque o XML soma o FCP-ST ao ICMS-ST. O despacho por CST não é espelhado: em CST que não emite o grupo, sai o valor registrado.","format":"float"},"valor_fcp_st":{"type":"number","nullable":true,"description":"Valor do FCP-ST. Valor registrado no item, formatado como as tags vBCFCPST/pFCPST/vFCPST. Preenchido só quando o item tem alíquota e valor do FCP-ST e a NF-e é 4.00, a mesma condição em que o XML emite o grupo; senão 0. Fora da 4.00 é sempre 0, porque o XML soma o FCP-ST ao ICMS-ST. O despacho por CST não é espelhado: em CST que não emite o grupo, sai o valor registrado.","format":"float"},"base_ibs_cbs":{"type":"number","nullable":true,"description":"Base de cálculo do IBS e da CBS (vBC do grupo gIBSCBS).","format":"float"},"aliquota_ibs_uf":{"type":"number","nullable":true,"description":"Alíquota do IBS estadual (pIBSUF).","format":"float"},"valor_ibs_uf":{"type":"number","nullable":true,"description":"Valor do IBS estadual (vIBSUF).","format":"float"},"aliquota_ibs_mun":{"type":"number","nullable":true,"description":"Alíquota do IBS municipal (pIBSMun).","format":"float"},"valor_ibs_mun":{"type":"number","nullable":true,"description":"Valor do IBS municipal (vIBSMun).","format":"float"},"aliquota_cbs":{"type":"number","nullable":true,"description":"Alíquota da CBS (pCBS).","format":"float"},"valor_cbs":{"type":"number","nullable":true,"description":"Valor da CBS (vCBS).","format":"float"}}}}}}}},"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"403":{"description":"Pessoa autenticada sem acesso à tela de movimentações de estoque","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"404":{"description":"Movimentação não encontrada","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```
