Finanças ·
MovimentosFinanceirosLista os movimentos financeiros de Contas a Pagar, Contas a Receber e Contas Correntes
1consulta
0alterações
Claude · ChatGPT · MCPpelos assistentes de IA
JSON · XMLformato
Obrigatórios 0
Nenhum campo obrigatório.
Opcionais 42Campos e estruturas que você pode enviar
| Campo | Tipo | Descrição |
|---|---|---|
cCPFCNPJCliente | texto · até 20 | Filtrar os títulos por CPF/CNPJ do cliente. |
cCodCateg | texto · até 20 | Código da Categoria. |
cCodIntTitulo | texto · até 60 | Código de integração do título. (Utilizado em títulos criados via API, não é visualizado na tela) |
cCodigoBarras | texto · até 70 | Código de Barras do título. |
cExibirDepartamentos | texto · até 1 | Exibir distribuição por departamentos (S/N). |
cNatureza | texto · até 1 | Filtrar os títulos pela natureza. Pode ser: P - Contas a Pagar. R - Contas a Receber. |
cNumCtr | texto · até 60 | Filtrar os títulos pelo número do contrato informado pelo usuário. |
cNumDocFiscal | texto · até 20 | Número do documento fiscal (NF-e, NFC-e, NFS-e, etc) (Informado pelo usuário / visualizado na tela) |
cNumOS | texto · até 15 | Filtrar os títulos pelo código da Ordem de Serviço. (Código visualizado na tela) |
cNumTitulo | texto · até 20 | Número do título. (Informado pelo usuário / visualizado na tela) |
cOperacao | texto · até 2 | Operação do título. Pode ser: 01 - Venda de Serviço 11 - Venda de Produto 12 - Venda de Produto pelo PDV 13 - Devolução de Venda 14 - Remessa de Produto 16 - Transferência 21 - Compra de Produto 23 - Devolução ao Fornecedor 24 - Retorno de Remessa 26 - Nota Complementar de Entrada 22 - Compra de Produto (Importação) 28 - Ordem de Produção |
cOrdemDecrescente | texto · até 1 | DEPRECATED |
cOrdenarPor | texto · até 100 | Ordem de exibição do dados. Pode ser: CODIGO CODIGO_INTEGRACAO |
cStatus | texto · até 100 | Filtrar os títulos pelo status. Pode ser: CANCELADO RECEBIDO LIQUIDADO EMABERTO PAGTO_PARCIAL VENCEHOJE AVENCER ATRASADO |
cTipo | texto · até 5 | Tipo de Documento. Pode ser: ADI - Adiantamento BOL - Boleto CRT - Cartão CHQ - Cheque CON - Convênios CRE - Crediário DRF - DARF DAS - DAS DEB - Débito em conta DIN - Dinheiro DOC - DOC GUIA - Guia de Recolhimento PROT - Protesto REC - Recibo RPA - RPA TED - TED TRA - Transferência 99999 - Outros Utilize a tag "codigo" do método "PesquisarTipoDocumento" da API: https://app.omie.com.br/api/v1/geral/tiposdoc/ para obter essa informação. |
cTpLancamento | texto · até 10 | Tipo de registro que será exibido. Pode ser: CP - Lançamentos de Contas a Pagar. CR - Lançamentos de Contas a Receber. CPCR - Lançamentos de Contas a Pagar e Receber. BX - Baixas de lançamentos de Contas a Pagar e Receber. BXCP - Baixas de lançamentos de Contas a Pagar. BXCR - Baixas de lançamentos de Contas a Receber. CC - Lançamentos (todos) no Conta Corrente. CCE - Lançamentos de entrada no Conta Corrente. CCS - Lançamentos de saída no Conta Corrente. CCT - Lançamentos de transferência no Conta Corrente. PV - Previsão de Contratos de Serviço. POS - Previsão de Ordens de Serviço. PPV - Previsão de Pedidos de Venda. |
dDtAltAte | texto · até 10 | Data de alteração |
dDtAltDe | texto · até 10 | Data de alteração |
dDtEmisAte | texto · até 10 | Filtrar os títulos pela data de emissão - até. |
dDtEmisDe | texto · até 10 | Filtrar os títulos pela data de emissão - a partir de. |
dDtIncAte | texto · até 10 | Data de inclusão |
dDtIncDe | texto · até 10 | Data de inclusão |
dDtPagtoAte | texto · até 10 | Filtrar os títulos pela data de pagamento - até. |
dDtPagtoDe | texto · até 10 | Filtrar os títulos pela data de pagamento - a partir de. |
dDtPrevAte | texto · até 10 | Data de previsão |
dDtPrevDe | texto · até 10 | Data de previsão |
dDtRegAte | texto · até 10 | Data de registro |
dDtRegDe | texto · até 10 | Data de registro |
dDtVencAte | texto · até 10 | Filtrar os títulos pela data de vencimento - até. |
dDtVencDe | texto · até 10 | Filtrar os títulos pela data de vencimento - a partir de. |
lDadosCad | sim/não | Exibir dados cadastrais como Data de Inclusão, Alteração do Título e Observações (S/N)? |
nCodCC | número inteiro | Filtrar os títulos pelo código da conta corrente. (Gerado internamente, não é visualizado na tela) |
nCodCliente | número inteiro | Filtrar os títulos pelo código do cliente. (Gerado internamente, não é visualizado na tela) |
nCodComprador | número inteiro | Código do comprador. (Gerado internamente, não é visualizado na tela) |
nCodCtr | número inteiro | Filtrar os títulos pelo código do contrato. (Gerado internamente, não é visualizado na tela) |
nCodMovCC | número inteiro | Código do movimento de Conta Corrente. |
nCodOS | número inteiro | Filtrar os títulos pelo código da Ordem de Serviço. (Gerado internamente, não é visualizado na tela) |
nCodProjeto | número inteiro | Código do projeto. (Gerado internamente, não é visualizado na tela) |
nCodTitulo | número inteiro | Código do titulo. (Gerado internamente, não é visualizado na tela) |
nCodVendedor | número inteiro | Código do vendedor. (Gerado internamente, não é visualizado na tela) |
nPagina | número inteiro | Número da página a ser recuperada. |
nRegPorPagina | número inteiro | Número de registros por página. (máximo 50). |
Retorno 5O que volta numa chamada bem-sucedida
| Campo | Tipo | Descrição |
|---|---|---|
movimentos | lista de objetos | |
movimentos[].categorias | lista de objetos | Distribuição por Categorias. |
movimentos[].categorias[].cCodCateg | texto | Código da Categoria. |
movimentos[].categorias[].nDistrPercentual | decimal | Percentual da distribuição. |
movimentos[].categorias[].nDistrValor | decimal | Valor da distribuição. |
movimentos[].categorias[].nValorFixo | texto | Indica que o valor foi fixado na distribuição (S/N). |
movimentos[].departamentos | lista de objetos | Distribuição por departamentos. |
movimentos[].departamentos[].cCodDepartamento | texto | Código do Departamento. |
movimentos[].departamentos[].nDistrPercentual | decimal | Percentual da distribuição. |
movimentos[].departamentos[].nDistrValor | decimal | Valor da distribuição. |
movimentos[].departamentos[].nValorFixo | texto | Indica que o valor foi fixado na distribuição (S/N). |
movimentos[].detalhes | objeto | Detalhes do movimento financeiro. |
movimentos[].detalhes.cCPFCNPJCliente | texto | Filtrar os títulos por CPF/CNPJ do cliente. |
movimentos[].detalhes.cChaveNFe | texto | Chave da NF-e de origem. |
movimentos[].detalhes.cCodCateg | texto | Código da categoria. |
movimentos[].detalhes.cCodIntTitulo | texto | Código de integração do título. (Utilizado em títulos criados via API, não é visualizado na tela) |
movimentos[].detalhes.cCodProjeto | número inteiro | Código do projeto. (Gerado internamente, não é visualizado na tela) |
movimentos[].detalhes.cCodVendedor | número inteiro | Código do vendedor. (Gerado internamente, não é visualizado na tela) |
movimentos[].detalhes.cCodigoBarras | texto | Código de Barras do título. |
movimentos[].detalhes.cGrupo | texto | Grupo do lançamento. |
movimentos[].detalhes.cHrAlt | texto | Hora de Alteração. |
movimentos[].detalhes.cHrConcilia | texto | Hora de conciliação. |
movimentos[].detalhes.cHrInc | texto | Hora de Inclusão. |
movimentos[].detalhes.cNSU | texto | Número Sequencial Único - Comprovante de pagamento. |
movimentos[].detalhes.cNatureza | texto | Natureza do título. Pode ser: P - Contas a Pagar R - Contas a Receber |
movimentos[].detalhes.cNumBoleto | texto | Número do Boleto. |
movimentos[].detalhes.cNumCtr | texto | Número do contrato associado ao título. (Informado pelo usuário / visualizado na tela) |
movimentos[].detalhes.cNumDocFiscal | texto | Número do documento fiscal (NF-e, NFC-e, NFS-e, etc) (Informado pelo usuário / visualizado na tela) |
movimentos[].detalhes.cNumOS | texto | Número do pedido de venda / Ordem de Serviço. (visualizado na tela) |
movimentos[].detalhes.cNumParcela | texto | Número da parcela "Formatada" como 999/999 |
movimentos[].detalhes.cNumTitulo | texto | Número do título. (Informado pelo usuário / visualizado na tela) |
movimentos[].detalhes.cOperacao | texto | Operação do título. Pode ser: 01 - Venda de Serviço 11 - Venda de Produto 12 - Venda de Produto pelo PDV 13 - Devolução de Venda 14 - Remessa de Produto 16 - Transferência 21 - Compra de Produto 23 - Devolução ao Fornecedor 24 - Retorno de Remessa 26 - Nota Complementar de Entrada 22 - Compra de Produto (Importação) 28 - Ordem de Produção |
movimentos[].detalhes.cOrigem | texto | Origem do lançamento. Pode ser: APBP Integração de Pagamento de Conta APBR Integração de Recebimento de Conta APEP Integração de Lançamento de Despesa APER Integração de Lançamento de Receita APIP Integração de Conta a Pagar APIR Integração de Conta a Receber BARP Conta a Pagar Importada por Código de Barras BARR Conta a Receber Importada por Código de Barras BAXP Pagamento de Conta a Pagar BAXR Recebimento de Conta a Receber COMP Parcela a Pagar de Compras DEVP Conta a Pagar da Devolução de Venda DEVR Conta a Receber da Devolução ao Fornecedor EXTP Lançamento Manual de Despesa EXTR Lançamento Manual de Receita IMPP Parcela a Pagar de uma Nota de Importação MANP Lançamento Manual de Conta a Pagar MANR Lançamento Manual de Conta a Receber NFEP Conta a Pagar Importada de uma NF-e NFER Conta a Receber Importada de uma NF-e OFXP Pagamento Importado de um arquivo OFX OFXR Recebimento Importado de um arquivo OFX RPTP Repetição de Contas a Pagar RPTR Repetição de Contas a Receber TRAP Débito de Transf. entre Contas Correntes TRAR Crédito de Transf. entre Contas Correntes VENR Parcela a Receber de Vendas XMLP Conta a Pagar Importada de um arquivo XML XMLR Conta a Receber Importada de um arquivo XML |
movimentos[].detalhes.cRetCOFINS | texto | Indica que o Valor do COFINS informado deve ser retido. |
movimentos[].detalhes.cRetCSLL | texto | Indica que o Valor do CSLL informado deve ser retido. |
movimentos[].detalhes.cRetINSS | texto | Indica que o Valor do INSS informado deve ser retido. |
movimentos[].detalhes.cRetIR | texto | Indica que o Valor do Imposto de Renda informado deve ser retido. |
movimentos[].detalhes.cRetISS | texto | Indica que o Valor do ISS informado deve ser retido. |
movimentos[].detalhes.cRetPIS | texto | Indica que o Valor do PIS informado deve ser retido. |
movimentos[].detalhes.cStatus | texto | Status do título. Pode ser: CANCELADO RECEBIDO LIQUIDADO EMABERTO PAGTO_PARCIAL VENCEHOJE AVENCER ATRASADO |
movimentos[].detalhes.cTipo | texto | Tipo de documento. Pode ser: ADI - Adiantamento BOL - Boleto CRT - Cartão CHQ - Cheque CON - Convênios CRE - Crediário DRF - DARF DAS - DAS DEB - Débito em conta DIN - Dinheiro DOC - DOC GUIA - Guia de Recolhimento PROT - Protesto REC - Recibo RPA - RPA TED - TED TRA - Transferência 99999 - Outros Utilize a tag "codigo" do método "PesquisarTipoDocumento" da API: https://app.omie.com.br/api/v1/geral/tiposdoc/ para obter essa informação. |
movimentos[].detalhes.cUsAlt | texto | Usuário de alteração. |
movimentos[].detalhes.cUsConcilia | texto | |
movimentos[].detalhes.cUsInc | texto | Usuário da Inclusão. |
movimentos[].detalhes.dDtAlt | texto | Data de Alteração. |
movimentos[].detalhes.dDtConcilia | texto | Data da conciliação. |
movimentos[].detalhes.dDtCredito | texto | Data de credito. |
movimentos[].detalhes.dDtEmissao | texto | Data de emissão do título. |
movimentos[].detalhes.dDtInc | texto | Data de Inclusão. |
movimentos[].detalhes.dDtPagamento | texto | Data de pagamento do título. |
movimentos[].detalhes.dDtPrevisao | texto | Data de previsão de Pagamento/Recebimento. |
movimentos[].detalhes.dDtRegistro | texto | Data de registro da NF. |
movimentos[].detalhes.dDtVenc | texto | Data de vencimento do título. |
movimentos[].detalhes.nCodBaixa | número inteiro | Código da baixa. |
movimentos[].detalhes.nCodCC | número inteiro | Código da conta corrente. (Gerado internamente, não é visualizado na tela) |
movimentos[].detalhes.nCodCliente | número inteiro | Código de Cliente / Fornecedor. (Gerado internamente, não é visualizado na tela) |
movimentos[].detalhes.nCodComprador | número inteiro | Código do comprador. (Gerado internamente, não é visualizado na tela) |
movimentos[].detalhes.nCodCtr | número inteiro | Código do contrato associado ao título. (Gerado internamente, não é visualizado na tela) |
movimentos[].detalhes.nCodMovCC | número inteiro | Código do movimento de Conta Corrente. |
movimentos[].detalhes.nCodMovCCRepet | número inteiro | Código do movimento de repetição, |
movimentos[].detalhes.nCodNF | número inteiro | Código da Nota Fiscal. |
movimentos[].detalhes.nCodOS | número inteiro | Código do Pedido de Venda / Ordem de Serviço. (Gerado internamente, não é visualizado na tela) |
movimentos[].detalhes.nCodTitRepet | número inteiro | Código do título original que gerou a repetição dos lançamentos. |
movimentos[].detalhes.nCodTitulo | número inteiro | Código do titulo. (Gerado internamente, não é visualizado na tela) |
movimentos[].detalhes.nDesconto | decimal | Valor do Desconto. |
movimentos[].detalhes.nJuros | decimal | Valor do Juros. |
movimentos[].detalhes.nMulta | decimal | Valor da Multa. |
movimentos[].detalhes.nValorCOFINS | decimal | Valor do COFINS. |
movimentos[].detalhes.nValorCSLL | decimal | Valor do CSLL. |
movimentos[].detalhes.nValorINSS | decimal | Valor do INSS. |
movimentos[].detalhes.nValorIR | decimal | Valor do Imposto de Renda. |
movimentos[].detalhes.nValorISS | decimal | Valor do ISS. |
movimentos[].detalhes.nValorMovCC | decimal | Valor do movimento de Conta Corrente. |
movimentos[].detalhes.nValorPIS | decimal | Valor do PIS. |
movimentos[].detalhes.nValorTitulo | decimal | Valor do título. |
movimentos[].detalhes.observacao | texto | Observações do título. |
movimentos[].resumo | objeto | Situação do movimento financeiro. |
movimentos[].resumo.cLiquidado | texto | Indica se o título está liquidado. Pode ser: S - Sim, indicado que o título está quitado. N - Não, indicando que o título ainda está em aberto. |
movimentos[].resumo.nDesconto | decimal | Valor do Desconto. |
movimentos[].resumo.nJuros | decimal | Valor do Juros. |
movimentos[].resumo.nMulta | decimal | Valor da Multa. |
movimentos[].resumo.nValAberto | decimal | Valor total em aberto para o título. |
movimentos[].resumo.nValLiquido | decimal | Valor líquido (nValPago - nDesconto + Juros + nMulta) |
movimentos[].resumo.nValPago | decimal | Valor total pago para o título. |
nPagina | número inteiro | |
nRegistros | número inteiro | |
nTotPaginas | número inteiro | |
nTotRegistros | número inteiro |
POST /api/v1/financas/mf/
curl -s https://app.omie.com.br/api/v1/financas/mf/ \
-H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
-H 'Content-Type: application/json' \
-d '{"call": "ListarMovimentos", "param": [{"nPagina": 1, "nRegPorPagina": 500}]}'import os
import requests
corpo = {'call': 'ListarMovimentos', 'param': [{'nPagina': 1, 'nRegPorPagina': 500}]}
resp = requests.post(
"https://app.omie.com.br/api/v1/financas/mf/",
headers={"Authorization": f"Bearer {os.environ['TOKEN_DO_APLICATIVO']}"},
json=corpo,
timeout=60,
)
print(resp.json())const resp = await fetch("https://app.omie.com.br/api/v1/financas/mf/", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TOKEN_DO_APLICATIVO}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"call": "ListarMovimentos",
"param": [
{
"nPagina": 1,
"nRegPorPagina": 500
}
]
}),
});
console.log(await resp.json());<?php
$ch = curl_init("https://app.omie.com.br/api/v1/financas/mf/");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("TOKEN_DO_APLICATIVO"),
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => <<<'JSON'
{
"call": "ListarMovimentos",
"param": [
{
"nPagina": 1,
"nRegPorPagina": 500
}
]
}
JSON,
]);
echo curl_exec($ch);require "net/http"
uri = URI("https://app.omie.com.br/api/v1/financas/mf/")
corpo = <<~'JSON'
{
"call": "ListarMovimentos",
"param": [
{
"nPagina": 1,
"nRegPorPagina": 500
}
]
}
JSON
resp = Net::HTTP.post(uri, corpo,
"Authorization" => "Bearer #{ENV.fetch('TOKEN_DO_APLICATIVO')}",
"Content-Type" => "application/json")
puts resp.bodyimport java.net.URI;
import java.net.http.*;
var corpo = """
{
"call": "ListarMovimentos",
"param": [
{
"nPagina": 1,
"nRegPorPagina": 500
}
]
}
""";
var pedido = HttpRequest.newBuilder()
.uri(URI.create("https://app.omie.com.br/api/v1/financas/mf/"))
.header("Authorization", "Bearer " + System.getenv("TOKEN_DO_APLICATIVO"))
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(corpo))
.build();
var resp = HttpClient.newHttpClient().send(pedido, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());// TokenDoAplicativo: parâmetro do Power BI (Página Inicial > Gerenciar parâmetros)
let
Resposta = Web.Contents(
"https://app.omie.com.br/api/v1/financas/mf/",
[
Headers = [Authorization = "Bearer " & TokenDoAplicativo, #"Content-Type" = "application/json"],
Content = Text.ToBinary("{""call"": ""ListarMovimentos"", ""param"": [{""nPagina"": 1, ""nRegPorPagina"": 500}]}")
]
),
Dados = Json.Document(Resposta)
in
Dados