OpenAPITodas as operações em OpenAPI (Postman, Insomnia).
Finanças · PIX

Inclusão de um PIX

POSThttps://app.omie.com.br/api/v1/financas/pix/WSDL
4consultas
3alterações
Claude · MCPpelos assistentes de IA
JSON · XMLformato

CancelarPix

altera dadosClaudeMCP

Efetua o cancelamento de um PIX

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 3Campos e estruturas que você pode enviar
CampoTipoDescrição
cCodIntPixtexto · até 60Código do lançamento gerado pelo integrador.
lDelsim/nãoIndica se a conta a receber será excluída ao efetuar o cancelamento do PIX. Ao ser preenchida com true a conta a receber que gerou o PIX será excluída. Pode ser: false true Default: true
nIdPixnúmero inteiroID do lançamento PIX. O conteúdo desse campo é o código interno gerado pelo Omie ao gerar o PIX. Esse campo não é exibido na tela do Omie, mas é a chave de integração via API. É uma informação interna, utilizada apenas nas APIs.
Retorno 2O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodStatustexto
cDescStatustexto
POST /api/v1/financas/pix/
curl -s https://app.omie.com.br/api/v1/financas/pix/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "CancelarPix", "param": [{"nIdPix": 0, "cCodIntPix": ""}]}'

GerarPix

altera dadosClaudeMCP

Gera o QrCode de um PIX.

Obrigatórios 1

CampoTipoDescrição
cCodIntPixtexto · até 60Código do lançamento gerado pelo integrador.
Opcionais 6Campos e estruturas que você pode enviar
CampoTipoDescrição
cCnpjCpftexto · até 20CNPJ/CPF do cliente. Informação utilizada para identificar o cadastro do Cliente. Utilize a tag "cbpj_cpf" do método "ListarClientes" da API /api/v1/geral/clientes/ para obter essa informação. Quando as tags "cIdCliente" e cCnpjCpf" não informadas, assumirá que o PIX foi realizado para um cliente consumidor padrão. Caso não exista um cliente consumidor cadastrado, o mesmo será criado automaticamente.
cUrlNotiftextoURL de CallBack que será acionada quando o pagamento for efetuado.
nCodTitulonúmero inteiroID da conta a receber que irá gerar o PIX. Caso essa tag não seja preenchida uma nova conta a receber será gerada.
nIdClientenúmero inteiroCódigo do cliente. Informação utilizada para identificar o cadastro do Cliente. Utilize a tag "codigo_cliente_omie" do método "ListarClientes" da API /api/v1/geral/clientes/ para obter essa informação. Quando as tags "cIdCliente" e cCnpjCpf" não informadas, assumirá que o PIX foi realizado para um cliente consumidor padrão. Caso não exista um cliente consumidor cadastrado, o mesmo será criado automaticamente. Essa tag não deve ser preenchida quando a tag "nCodTitulo" for informada.
nIdContanúmero inteiroCódigo da Conta Corrente. Caso não informado, assumirá a conta omie.CASH Utilize a tag "codigo" do método "PesquisarContaCorrente" da API http://app.omie.com.br/api/v1/geral/contacorrente/ para obter essa informação. Essa tag não deve ser preenchida quando a tag "nCodTitulo" for informada.
vValornúmeroValor do PIX.
Retorno 9O que volta numa chamada bem-sucedida
CampoTipoDescrição
cClientenúmero inteiroCódigo do Cliente pagador do PIX.
cCodIntPixtextoCódigo do lançamento gerado pelo integrador.
cCodStatustexto
cCopiaColatextoCódigo gerado a partir do QR Code para pagamento do PIX.
cDescStatustexto
cQrCodetextoString para a renderização do QR Code PIX.
cUrlPixtextoLink para obter o PDF do QrCode do PIX.
nCodTitulonúmero inteiroCódigo da Conta a Receber.
nIdPixnúmero inteiroID do lançamento PIX. O conteúdo desse campo é o código interno gerado pelo Omie ao gerar o PIX. Esse campo não é exibido na tela do Omie, mas é a chave de integração via API. É uma informação interna, utilizada apenas nas APIs.
POST /api/v1/financas/pix/
curl -s https://app.omie.com.br/api/v1/financas/pix/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "GerarPix", "param": [{"cCodIntPix": "1670867357", "nIdCliente": 0, "vValor": 1.99, "nIdConta": 0, "cUrlNotif": ""}]}'

GerarQrCodePix

altera dadosClaudeMCP

Gera um QrCode estático para pagamentos.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 1Campos e estruturas que você pode enviar
CampoTipoDescrição
nIdContanúmero inteiroCódigo da Conta Corrente. Caso não informado, assumirá a conta omie.CASH Utilize a tag "codigo" do método "PesquisarContaCorrente" da API http://app.omie.com.br/api/v1/geral/contacorrente/ para obter essa informação.
Retorno 5O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodStatustexto
cCopiaColatextoCódigo gerado a partir do QR Code para pagamento do PIX.
cDescStatustexto
cQrCodetextoString para a renderização do QR Code PIX.
cUrlPixtextoLink para obter o PDF do QrCode do PIX.
POST /api/v1/financas/pix/
curl -s https://app.omie.com.br/api/v1/financas/pix/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "GerarQrCodePix", "param": [{"nIdConta": 0}]}'

ListarPix

consultaClaudeMCP

Obtém a lista de detalhes dos PIX.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 5Campos e estruturas que você pode enviar
CampoTipoDescrição
cStatustexto · até 100Status do PIX. Pode ser: LIQUIDADO CANCELADO REGISTRADO
dEmissaoAtetexto · até 10Filtrar pela data de emissão - Ate.
dEmissaoDetexto · até 10Filtrar pela data de emissão - de.
nPaginanúmero inteiro
nRegPorPaginanúmero inteiro
Retorno 5O que volta numa chamada bem-sucedida
CampoTipoDescrição
ListaPixlista de objetos
ListaPix[].cClientenúmero inteiroCódigo do Cliente pagador do PIX
ListaPix[].cCodIntPixtextoCódigo do lançamento gerado pelo integrador.
ListaPix[].cCopiaColatextoCódigo gerado a partir do QR Code para pagamento do PIX.
ListaPix[].cInfoobjetoInformações sobre o cadastro do PIX.
ListaPix[].cInfo.dAlttextoData da Alteração. No formato dd/mm/aaaa.
ListaPix[].cInfo.dInctextoData da Inclusão. No formato dd/mm/aaaa.
ListaPix[].cInfo.hAlttextoHora da Alteração. No formato hh:mm:ss.
ListaPix[].cInfo.hInctextoHora da Inclusão. No formato hh:mm:ss.
ListaPix[].cInfo.uAlttextoUsuário da Alteração.
ListaPix[].cInfo.uInctextoUsuário da Inclusão.
ListaPix[].cStatustextoStatus do PIX. Pode ser: LIQUIDADO CANCELADO REGISTRADO
ListaPix[].cUrlPixtextoLink para obter o PDF do QrCode do PIX.
ListaPix[].dEmissaotextoData de emissão.
ListaPix[].dVencimentotextoData de vencimento.
ListaPix[].nCodTitulonúmero inteiroCódigo da Conta a Receber.
ListaPix[].nIdPixnúmero inteiroID do lançamento PIX. O conteúdo desse campo é o código interno gerado pelo Omie ao gerar o PIX. Esse campo não é exibido na tela do Omie, mas é a chave de integração via API. É uma informação interna, utilizada apenas nas APIs.
ListaPix[].vValordecimalValor do PIX.
nPaginanúmero inteiro
nRegistrosnúmero inteiro
nTotPaginasnúmero inteiro
nTotRegistrosnúmero inteiro
POST /api/v1/financas/pix/
curl -s https://app.omie.com.br/api/v1/financas/pix/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ListarPix", "param": [{"nPagina": 1, "nRegPorPagina": 50}]}'

ListarStatusPix

consultaClaudeMCP

Obtém a lista de Status dos PIX.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 5Campos e estruturas que você pode enviar
CampoTipoDescrição
cStatustexto · até 100Status do PIX. Pode ser: LIQUIDADO CANCELADO REGISTRADO
dEmissaoAtetexto · até 10Filtrar pela data de emissão - Ate.
dEmissaoDetexto · até 10Filtrar pela data de emissão - de.
nPaginanúmero inteiro
nRegPorPaginanúmero inteiro
Retorno 5O que volta numa chamada bem-sucedida
CampoTipoDescrição
ListaStatusPixlista de objetos
ListaStatusPix[].cCodIntPixtextoCódigo do lançamento gerado pelo integrador.
ListaStatusPix[].cStatustextoStatus do PIX. Pode ser: LIQUIDADO CANCELADO REGISTRADO
ListaStatusPix[].nCodTitulonúmero inteiroChave do Conta a Receber.
ListaStatusPix[].nIdPixnúmero inteiroID do lançamento PIX. O conteúdo desse campo é o código interno gerado pelo Omie ao gerar o PIX. Esse campo não é exibido na tela do Omie, mas é a chave de integração via API. É uma informação interna, utilizada apenas nas APIs.
ListaStatusPix[].vValordecimalValor do PIX.
nPaginanúmero inteiro
nRegistrosnúmero inteiro
nTotPaginasnúmero inteiro
nTotRegistrosnúmero inteiro
POST /api/v1/financas/pix/
curl -s https://app.omie.com.br/api/v1/financas/pix/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ListarStatusPix", "param": [{"nPagina": 1, "nRegPorPagina": 50}]}'

ObterPix

consultaClaudeMCP

Obtém os dados doPIX.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 3Campos e estruturas que você pode enviar
CampoTipoDescrição
cCodIntPixtexto · até 60Código do lançamento gerado pelo integrador.
nCodTitulonúmero inteiroCódigo do Título a Receber referente ao PIX.
nIdPixnúmero inteiroID do lançamento PIX. O conteúdo desse campo é o código interno gerado pelo Omie ao gerar o PIX. Esse campo não é exibido na tela do Omie, mas é a chave de integração via API. É uma informação interna, utilizada apenas nas APIs.
Retorno 12O que volta numa chamada bem-sucedida
CampoTipoDescrição
cClientenúmero inteiroCódigo do Cliente pagador do PIX
cCodIntPixtextoCódigo do lançamento gerado pelo integrador.
cCopiaColatextoCódigo gerado a partir do QR Code para pagamento do PIX.
cInfoobjetoInformações sobre o cadastro do PIX.
cInfo.dAlttextoData da Alteração. No formato dd/mm/aaaa.
cInfo.dInctextoData da Inclusão. No formato dd/mm/aaaa.
cInfo.hAlttextoHora da Alteração. No formato hh:mm:ss.
cInfo.hInctextoHora da Inclusão. No formato hh:mm:ss.
cInfo.uAlttextoUsuário da Alteração.
cInfo.uInctextoUsuário da Inclusão.
cQrCodetextoString para a renderização do QR Code PIX.
cStatustextoStatus do PIX. Pode ser: LIQUIDADO CANCELADO REGISTRADO
cUrlPixtextoLink para obter o PDF do QrCode do PIX.
dEmissaotextoData de emissão.
dVencimentotextoData de vencimento.
nCodTitulonúmero inteiroCódigo da Conta a Receber.
nIdPixnúmero inteiroID do lançamento PIX. O conteúdo desse campo é o código interno gerado pelo Omie ao gerar o PIX. Esse campo não é exibido na tela do Omie, mas é a chave de integração via API. É uma informação interna, utilizada apenas nas APIs.
vValordecimalValor do PIX.
POST /api/v1/financas/pix/
curl -s https://app.omie.com.br/api/v1/financas/pix/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ObterPix", "param": [{"nIdPix": 0, "cCodIntPix": "", "nCodTitulo": 0}]}'

ObterStatusPix

consultaClaudeMCP

Obtém o Status de um PIX.

Obrigatórios 0

Nenhum campo obrigatório.

Opcionais 3Campos e estruturas que você pode enviar
CampoTipoDescrição
cCodIntPixtexto · até 60Código do lançamento gerado pelo integrador.
nCodTitulonúmero inteiroCódigo do Título a Receber referente ao PIX.
nIdPixnúmero inteiroID do lançamento PIX. O conteúdo desse campo é o código interno gerado pelo Omie ao gerar o PIX. Esse campo não é exibido na tela do Omie, mas é a chave de integração via API. É uma informação interna, utilizada apenas nas APIs.
Retorno 5O que volta numa chamada bem-sucedida
CampoTipoDescrição
cCodIntPixtextoCódigo do lançamento gerado pelo integrador.
cStatustextoStatus do PIX. Pode ser: LIQUIDADO CANCELADO REGISTRADO
nCodTitulonúmero inteiroChave da Conta a Receber.
nIdPixnúmero inteiroID do lançamento PIX. O conteúdo desse campo é o código interno gerado pelo Omie ao gerar o PIX. Esse campo não é exibido na tela do Omie, mas é a chave de integração via API. É uma informação interna, utilizada apenas nas APIs.
vValordecimalValor do PIX.
POST /api/v1/financas/pix/
curl -s https://app.omie.com.br/api/v1/financas/pix/ \
  -H "Authorization: Bearer $TOKEN_DO_APLICATIVO" \
  -H 'Content-Type: application/json' \
  -d '{"call": "ObterStatusPix", "param": [{"nIdPix": 0, "cCodIntPix": "", "nCodTitulo": 0}]}'