OpenAPITodas as operações em OpenAPI (Postman, Insomnia).
Produtos · ecf_blocoX

Dados da exportação do bloco X

POSThttps://app.omie.com.br/api/v1/produtos/blocox/WSDL
1consulta
0alterações
Claude · MCPpelos assistentes de IA
JSON · XMLformato

ListarNFsBlocoX

consultaClaudeMCP

Lista as NFs para o Bloco X (ECF)

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 16Campos e estruturas que você pode enviar
CampoTipoDescrição
cOrdenarPortexto · até 100Ordem dos resultados: CODIGO - código da nota (padrão). DATA_EMISSAO - data de emissão. DATA_ENTRADA - data de saída informada pelo fornecedor. DATA_REGISTRO - data do registro do recebimento.
cSerietexto · até 5Série da NF-e (comparação exata).
dAltFinaltexto · até 10Data de alteração do recebimento, final, no formato dd/mm/aaaa.
dAltInicialtexto · até 10Data de alteração do recebimento, inicial, no formato dd/mm/aaaa.
dEmiFinaltexto · até 10Data de emissão final, no formato dd/mm/aaaa.
dEmiInicialtexto · até 10Data de emissão inicial, no formato dd/mm/aaaa.
dIncFinaltexto · até 10Data de inclusão do recebimento, final, no formato dd/mm/aaaa.
dIncInicialtexto · até 10Data de inclusão do recebimento, inicial, no formato dd/mm/aaaa.
dRegFinaltexto · até 10Data de registro do recebimento na Omie, final, no formato dd/mm/aaaa.
dRegInicialtexto · até 10Data de registro do recebimento na Omie, inicial, no formato dd/mm/aaaa.
dSaiEntFinaltexto · até 10Data de saída informada pelo fornecedor, final, no formato dd/mm/aaaa.
dSaiEntInicialtexto · até 10Data de saída informada pelo fornecedor, inicial, no formato dd/mm/aaaa.
nNFFinalnúmero inteiroNúmero final da NF-e.
nNFInicialnúmero inteiroNúmero inicial da NF-e.
nPaginanúmero inteiroNúmero da página. Padrão 1. A paginação conta itens de nota, não notas.
nRegPorPaginanúmero inteiroItens por página. Padrão 100, máximo 100 (valor maior volta a 100).
Retorno 5O que volta numa chamada bem-sucedida
CampoTipoDescrição
listaNFslista de objetosNotas de entrada encontradas, cada uma com o cabeçalho (ide) e os itens da página.
listaNFs[].ideobjetoCabeçalho da NF-e de entrada.
listaNFs[].ide.IdFornnúmero inteiroCódigo interno do fornecedor (cadastro de clientes e fornecedores).
listaNFs[].ide.chNFetextoChave da NF-e.
listaNFs[].ide.cnpjForntextoCNPJ do fornecedor.
listaNFs[].ide.dAlttextoData de alteração do recebimento, no formato dd/mm/aaaa.
listaNFs[].ide.dEmitextoData de emissão da NF-e, no formato dd/mm/aaaa.
listaNFs[].ide.dInctextoData de inclusão do recebimento, no formato dd/mm/aaaa.
listaNFs[].ide.dRegtextoData de saída informada pelo fornecedor, no formato dd/mm/aaaa (apesar do nome, não é a data de registro).
listaNFs[].ide.dSaiEnttextoData do registro do recebimento na Omie, no formato dd/mm/aaaa (apesar do nome, não é a data de saída do fornecedor).
listaNFs[].ide.idNFnúmero inteiroCódigo interno da nota fiscal na Omie.
listaNFs[].ide.lAjustesim/nãoIndica se é uma NF-e de ajuste (finalidade 3).
listaNFs[].ide.lCanceladasim/nãoIndica se a NF-e foi cancelada.
listaNFs[].ide.lComplementarsim/nãoIndica se é uma NF-e complementar (finalidade 2).
listaNFs[].ide.lDenegadasim/nãoIndica se a NF-e foi denegada.
listaNFs[].ide.modelotextoModelo do documento fiscal. Sempre 55.
listaNFs[].ide.nNFtextoNúmero do Documento Fiscal.
listaNFs[].ide.razaoForntextoRazão Social do Fornecedor.
listaNFs[].ide.serietextoSérie do Documento Fiscal
listaNFs[].itenslista de objetosItens de produto da nota marcados para cupom fiscal.
listaNFs[].itens[].EANtextoCódigo de barras (EAN) do produto informado no item da nota.
listaNFs[].itens[].cProdtextoCódigo do produto na Omie (ou o código da nota, se o produto não estiver vinculado).
listaNFs[].itens[].nIdProdnúmero inteiroCódigo interno do produto na Omie.
listaNFs[].itens[].nItemnúmero inteiroNúmero sequencial do item na nota.
listaNFs[].itens[].pICMSdecimalAlíquota de ICMS (zerada quando não há crédito).
listaNFs[].itens[].pICMSSTdecimalAlíquota do ICMS ST (só para indústria ou equiparada).
listaNFs[].itens[].qTribdecimalQuantidade do item.
listaNFs[].itens[].uTribtextoUnidade Tributável.
listaNFs[].itens[].vBCdecimalBase de cálculo do ICMS (zerada quando não há crédito).
listaNFs[].itens[].vBCSTdecimalBase de cálculo do ICMS ST (só para indústria ou equiparada).
listaNFs[].itens[].vDescdecimalValor do desconto do item.
listaNFs[].itens[].vICMSdecimalValor do ICMS (zerado quando não há crédito).
listaNFs[].itens[].vNFdecimalValor total do item na nota.
listaNFs[].itens[].vProddecimalValor da mercadoria no recebimento.
listaNFs[].itens[].vSTdecimalValor do ICMS ST (só para indústria ou equiparada).
listaNFs[].itens[].vUnTribdecimalValor unitário do item.
nPaginanúmero inteiroNúmero da página devolvida.
nRegistrosnúmero inteiroItens devolvidos nesta página.
nTotPaginasnúmero inteiroTotal de páginas (de itens).
nTotRegistrosnúmero inteiroTotal de itens encontrados.
POST /api/v1/produtos/blocox/
curl -s https://app.omie.com.br/api/v1/produtos/blocox/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ListarNFsBlocoX", "param": [{"nPagina": 1, "nRegPorPagina": 100, "cOrdenarPor": "DATA_REGISTRO", "dRegInicial": "01/09/2026", "dRegFinal": "30/09/2026"}]}'