Skip to main content

Conta Azul

Manage your finances, sales, customers, and inventory with Conta Azul ERP system.

Conta Azul Logo

Authentication​

This connector uses OAuth 2.0 authentication.

info

Set up your connection in the Abstra Console before using it in your workflows.

How to use​

Using the Smart Chat​

Execute the action "CHOOSE_ONE_ACTION_BELOW" from my connector "YOUR_CONNECTOR_NAME" using the params "PARAMS_HERE".

Using the Web Editor​

from abstra.connectors import run_connection_action

result = run_connection_action(
connection_name="your_connection_name",
action_name="your_action_name",
params={
"param1": "value1",
"param2": "value2"
})

Available Actions​

This connector provides 64 actions:

ActionPurposeParameters
acquittance/post_v1_financeiro_eventos_financeiros_parcelas_by_parcela_id_baixaCria uma baixa para uma parcela específicaparcela_id (string) required
data: {
. data_pagamento (string)
. composicao_valor (object)
. conta_financeira (string)
. metodo_pagamento (string)
. observacao (string)
. nsu (string)
} (object) required
acquittance/get_v1_financeiro_eventos_financeiros_parcelas_by_parcela_id_baixaLista todas as baixas associadas ao id da parcelaparcela_id (string) required
acquittance/patch_v1_financeiro_eventos_financeiros_baixas_by_baixa_idAtualiza os dados de uma baixa existentebaixa_id (string) required
data: {
. versao (integer)
. data_pagamento (string)
. composicao_valor (object)
. conta_financeira (string)
. metodo_pagamento (string)
. observacao (string)
. nsu (string)
} (object) required
acquittance/delete_v1_financeiro_eventos_financeiros_baixas_by_baixa_idRemove uma baixa pelo id fornecidobaixa_id (string) required
acquittance/get_v1_financeiro_eventos_financeiros_baixas_by_baixa_idRetorna os detalhes de uma baixa pelo id fornecidobaixa_id (string) required
charge/get_v1_financeiro_eventos_financeiros_contas_a_receber_cobranca_by_id_cobrancaRetorna os detalhes de uma cobrança específica pelo idid_cobranca (string) required
charge/delete_v1_financeiro_eventos_financeiros_contas_a_receber_cobranca_by_id_cobrancaCancela uma cobrança específica pelo idid_cobranca (string) required
charge/post_v1_financeiro_eventos_financeiros_contas_a_receber_gerar_cobrancaGera uma nova cobrançadata: {
. conta_bancaria (string)
. descricao_fatura (string)
. id_parcela (string)
. data_vencimento (string)
. tipo (string)
. atributos (object)
} (object) required
contracts/post_v1_contratosCria um novo contrato com base nos dados fornecidosdata: {
. id_cliente (string)
. data_emissao (string)
. id_categoria (string)
. id_centro_custo (string)
. id_vendedor (string)
. observacoes (string)
. observacoes_pagamento (string)
. termos (object)
. composicao_de_valor (object)
. condicao_pagamento (object)
. itens (array)
} (object) required
contracts/get_v1_contratosRetorna contratos com base nos filtros fornecidospagina (number)
tamanho_pagina (number)
campo_ordenado_ascendente (string)
campo_ordenado_descendente (string)
busca_textual (string)
cliente_id (string)
data_inicio (string) required
data_fim (string) required
contracts/get_v1_contratos_proximo_numeroRetornar o próximo número do contrato disponívelNo parameters
financial/get_v1_centro_de_custoRetorna os centros de custo cadastrados que atendam às condições do filtro aplicado - utilizados para classificar lançamentos financeiros e facilitar o controle e análise de pagamentos e recebimentospagina (number) required
tamanho_pagina (number) required
busca (string)
filtro_rapido (string)
campo_ordenado_ascendente (string)
campo_ordenado_descendente (string)
financial/post_v1_centro_de_custoCria um novo centro de custo e retorna os detalhes do centro de custo criadodata: {
. codigo (string)
. nome (string)
} (object) required
financial/get_v1_financeiro_eventos_financeiros_by_id_evento_parcelasRetorna as parcelas de acordo com o id do evento financeiro informadoid_evento (string) required
financial/get_v1_categoriasProcura e retorna as categorias que atendam às condições do filtro aplicadopagina (number) required
tamanho_pagina (number) required
campo_ordenado_ascendente (string)
campo_ordenado_descendente (string)
busca (string)
tipo (string)
apenas_filhos (boolean)
nome (string)
permite_apenas_filhos (boolean) required
financial/get_v1_financeiro_categorias_dreEste endpoint permite listar a estrutura completa de categorias da Demonstração do Resultado do Exercício DRE, composta por categorias principais e subcategorias hierárquicasNo parameters
financial/get_v1_conta_financeiraProcura e retorna as contas financeiras que atendam às condições do filtro aplicadopagina (integer)
tamanho_pagina (integer)
tipos (array)
nome (string)
apenas_ativo (boolean)
esconde_conta_digital (boolean)
mostrar_caixinha (boolean)
financial/get_v1_conta_financeira_by_id_conta_financeira_saldo_atualEste endpoint tem como objetivo disponibilizar, de forma simples e direta, o saldo atual de uma conta financeira específica, identificada pelo seu id_conta_financeiraid_conta_financeira (string) required
financial/post_v1_financeiro_eventos_financeiros_contas_a_receberCria o evento financeiro de contas a receber e retorna o protocolo da operaçãodata: {
. data_competencia (string)
. valor (number)
. observacao (string)
. descricao (string)
. contato (string)
. conta_financeira (string)
. rateio (array)
. condicao_pagamento (object)
} (object) required
financial/get_v1_financeiro_eventos_financeiros_contas_a_receber_buscarRetorna uma lista de lançamentos financeiros baseado nos filtrospagina (integer) required
tamanho_pagina (integer) required
campo_ordenado_ascendente (string)
campo_ordenado_descendente (string)
descricao (string)
data_vencimento_de (string) required
data_vencimento_ate (string) required
data_competencia_de (string)
data_competencia_ate (string)
data_pagamento_de (string)
data_pagamento_ate (string)
data_alteracao_de (string)
data_alteracao_ate (string)
valor_de (string)
valor_ate (string)
status (array)
ids_contas_financeiras (array)
ids_categorias (array)
ids_centros_de_custo (array)
financial/post_v1_financeiro_eventos_financeiros_contas_a_pagarCria o evento financeiro de contas a pagar e retorna o protocolo da operaçãodata: {
. data_competencia (string)
. valor (number)
. observacao (string)
. descricao (string)
. contato (string)
. conta_financeira (string)
. rateio (array)
. condicao_pagamento (object)
} (object) required
financial/get_v1_financeiro_eventos_financeiros_contas_a_pagar_buscarRetorna uma lista de lançamentos financeiros baseado nos filtrospagina (integer) required
tamanho_pagina (integer) required
campo_ordenado_ascendente (string)
campo_ordenado_descendente (string)
descricao (string)
data_vencimento_de (string) required
data_vencimento_ate (string) required
data_competencia_de (string)
data_competencia_ate (string)
data_pagamento_de (string)
data_pagamento_ate (string)
data_alteracao_de (string)
data_alteracao_ate (string)
valor_de (string)
valor_ate (string)
status (array)
ids_contas_financeiras (array)
ids_categorias (array)
ids_centros_de_custo (array)
financial/get_v1_financeiro_eventos_financeiros_parcelas_by_idRetorna as informações de uma parcela específica pelo seu idid (string) required
financial/patch_v1_financeiro_eventos_financeiros_parcelas_by_idAtualiza as informações de uma parcela do evento financeiro. - Sempre deverá ser enviado o campo VERSÃO com o valor atualizado do registro. - Não é necessário o envio do objeto inteiro, apenas os campos que serão atualizadosid (string) required
data: {
. nota (string)
. descricao (string)
. vencimento (string)
. composicao_valor (object)
. versao (integer)
. data_pagamento_esperado (string)
. metodo_pagamento (string)
. perda (object)
. nsu (string)
. pagamento_agendado (boolean)
. id_conta_financeira (string)
} (object) required
inventory/get_v1_produtosRetornar os produtos por filtropagina (integer)
tamanho_pagina (integer)
campo_ordenacao (string)
direcao_ordenacao (string)
busca (string)
status (string)
integracao_ecommerce_ativo (boolean)
produtos_kit_ativo (boolean)
valor_venda_inicial (number)
valor_venda_final (number)
sku (string)
data_alteracao_de (string)
data_alteracao_ate (string)
inventory/post_v1_produtosCriar um novo produtodata: {
. ativo (boolean)
. categoria
. codigo_ean (string)
. codigo_sku (string)
. conversoes_unidade_medida (array)
. descricao (string)
. detalhe_kit
. ecommerce
. estoque
. fiscal
. formato
. id_centro_custo (string)
. nome (string)
. pesos_dimensoes
. status
. unidade_medida
. variacao
} (object) required
inventory/get_v1_produtos_categoriasRetornar as categorias por filtropagina (integer)
tamanho_pagina (integer)
busca_textual (string)
inventory/get_v1_produtos_cestRetornar os cests por filtropagina (integer)
tamanho_pagina (integer)
busca_textual (string)
inventory/get_v1_produtos_ecommerce_categoriasRetornar as categorias de e-commerce por filtrobusca_textual (string)
inventory/get_v1_produtos_ecommerce_marcasRetornar as marcas de ecommerce por filtropagina (integer)
tamanho_pagina (integer)
direcao (string)
busca_textual (string)
inventory/get_v1_produtos_ncmRetornar os ncms por filtropagina (integer)
tamanho_pagina (integer)
busca_textual (string)
inventory/get_v1_produtos_unidades_medidaRetornar as unidades de medida por filtropagina (integer)
tamanho_pagina (integer)
busca_textual (string)
inventory/get_v1_produtos_by_idRetornar o produto por idid (string) required
inventory/delete_v1_produtos_by_idDeletar produto por idid (string) required
inventory/patch_v1_produtos_by_idAtualizar parcialmente um produto por idid (string) required
data: {
. cest (integer)
. codigo_ean (string)
. codigo_sku (string)
. ncm (integer)
. nome (string)
. peso_bruto (number)
. peso_liquido (number)
. unidade_medida (integer)
. valor_venda (number)
} (object) required
invoice/get_v1_notas_fiscaisPermite consultar todas as notas fiscais de produto NFe já emitidas no ERP, com suporte a filtros como data, número da nota, id da venda.. Este endpoint retorna somente NFe com status EMITIDA e CORRIGIDA COM SUCESSO outros status em construção. Essa funcionalidade facilita o monitoramento fiscal, exportação para relatórios ou integração com contabilidade.data_inicial (string) required
data_final (string) required
pagina (integer)
tamanho_pagina (integer)
documento_tomador (string)
numero_nota (string)
id_venda (string)
invoice/get_v1_notas_fiscais_servicoPermite consultar todas as notas fiscais de serviço NFS-e já emitidas no ERP, com uso de filtros como data, número da nota, id da venda.. Este endpoint retorna NFS-e com todos os status possíveis a partir da emissão. Essa funcionalidade facilita o monitoramento fiscal, exportação para relatórios ou integração com contabilidade.pagina (integer)
tamanho_pagina (integer)
data_competencia_de (string) required
data_competencia_ate (string) required
ids (array)
id_cliente (array)
numero_venda (integer)
numero_nfse_inicial (integer)
numero_nfse_final (integer)
numero_rps_inicial (integer)
numero_rps_final (integer)
status (array)
tipo_negociacao (string)
invoice/post_v1_notas_fiscais_vinculo_mdfePermite associar uma ou mais notas fiscais identificadas pelas chaves de acesso a um MDF-e Manifesto Eletrônico de Documento Fiscal. É possível também informar o status do vínculo ex: 'AUTORIZADO', 'ENCERRADO', 'CANCELADO'. Apoio no controle logístico e fiscal.data: {
. chaves_acesso (array)
. identificador (string)
. status
} (object) required
invoice/get_v1_notas_fiscais_by_chavePermite consultar dados de uma nota fiscal específica, buscando pela sua chave de acessochave (string) required
person/get_v1_pessoasRetornar as pessoas por filtropagina (integer)
tamanho_pagina (integer)
tipo_ordenacao (string)
ordem_ordenacao (string)
busca (string)
ids (string)
documentos (string)
paises (string)
cidades (string)
ufs (string)
codigos_pessoa (string)
emails (string)
tipos_pessoa (string)
nomes (string)
telefones (string)
data_criacao_inicio (string)
data_criacao_fim (string)
data_alteracao_de (string)
data_alteracao_ate (string)
tipo_perfil (string)
com_endereco (boolean)
person/post_v1_pessoasCriar uma nova pessoadata: {
. agencia_publica (boolean)
. ativo (boolean)
. cnpj (string)
. codigo (string)
. cpf (string)
. data_nascimento (string)
. email (string)
. enderecos (array)
. inscricoes (array)
. nome (string)
. nome_fantasia (string)
. observacao (string)
. optante_simples (boolean)
. outros_contatos (array)
. perfis (array)
. rg (string)
. telefone_celular (string)
. telefone_comercial (string)
. tipo_pessoa
} (object) required
person/post_v1_pessoas_ativarAtivar pessoas em lotedata: {
. uuids (array)
} (object) required
person/post_v1_pessoas_excluirExcluir pessoas em lotedata: {
. uuids (array)
} (object) required
person/post_v1_pessoas_inativarDesativar pessoas em lotedata: {
. uuids (array)
} (object) required
person/get_v1_pessoas_legado_by_idRetornar a pessoa por legacyidid (string) required
person/get_v1_pessoas_by_idRetornar a pessoa por idid (string) required
person/put_v1_pessoas_by_idAtualizar uma pessoa por idid (string) required
data: {
. agencia_publica (boolean)
. ativo (boolean)
. cnpj (string)
. codigo (string)
. cpf (string)
. data_nascimento (string)
. email (string)
. enderecos (array)
. inscricoes (array)
. nome (string)
. nome_fantasia (string)
. observacao (string)
. optante_simples (boolean)
. outros_contatos (array)
. perfis (array)
. rg (string)
. telefone_celular (string)
. telefone_comercial (string)
. tipo_pessoa
} (object) required
person/patch_v1_pessoas_by_idAtualizar parcialmente uma pessoa por idid (string) required
data: {
. agencia_publica (boolean)
. ativo (boolean)
. cnpj (string)
. codigo (string)
. cpf (string)
. data_nascimento (string)
. email (string)
. enderecos (array)
. inscricoes (array)
. nome (string)
. nome_empresa (string)
. observacao (string)
. optante_simples_nacional (boolean)
. perfis (array)
. rg (string)
. telefone_celular (string)
. telefone_comercial (string)
. tipo_pessoa
} (object) required
service/get_v1_servicosRetornar os serviços por filtropagina (integer)
tamanho_pagina (integer)
busca_textual (string)
service/post_v1_servicosCriar um novo serviçodata: {
. codigo (string)
. custo (number)
. descricao (string)
. preco (number)
. status
. tipo_servico
} (object) required
service/delete_v1_servicosDeletar serviços em lotedata: {
. ids (array)
} (object) required
service/get_v1_servicos_by_idRetornar o serviço por idid (string) required
service/patch_v1_servicos_by_idAtualizar parcialmente um serviço por idid (string) required
data: {
. codigo (string)
. custo (number)
. descricao (string)
. preco (number)
. tipo_servico
} (object) required
protocol/get_v1_protocolo_by_idRetorna o protocolo correspondente ao id fornecidoid (string) required
sales/get_v1_venda_vendedoresRetorna a lista total de vendedores disponíveisNo parameters
sales/get_v1_venda_by_idRetornar a venda por idid (string) required
sales/put_v1_venda_by_idAtualizar uma venda por idid (string) required
data: {
. id_cliente (string)
. numero (integer)
. data_venda (string)
. situacao (string)
. observacoes (string)
. observacoes_pagamento (string)
. id_natureza_operacao (string)
. versao (integer)
. itens (array)
. composicao_de_valor (object)
. condicao_pagamento (object)
} (object) required
sales/get_v1_venda_buscaLista vendas utilizando filtros fornecidos como parâmetros de consultapagina (integer)
tamanho_pagina (integer)
campo_ordenado_ascendente (string)
campo_ordenado_descendente (string)
termo_busca (string)
data_inicio (string)
data_fim (string)
data_criacao_de (string)
data_criacao_ate (string)
data_alteracao_de (string)
data_alteracao_ate (string)
ids_vendedores (array)
ids_clientes (array)
ids_natureza_operacao (array)
situacoes (array)
tipos (array)
origens (array)
numeros (array)
ids_categorias (array)
ids_produtos (array)
pendente (boolean)
totais (string)
ids_legado_donos (array)
ids_legado_clientes (array)
ids_legado_produtos (array)
ids_legado_categorias (array)
sales/post_v1_vendaCriar uma nova vendadata: {
. id_cliente (string)
. numero (integer)
. situacao (string)
. data_venda (string)
. id_categoria (string)
. id_centro_custo (string)
. id_vendedor (string)
. observacoes (string)
. observacoes_pagamento (string)
. itens (array)
. composicao_de_valor (object)
. condicao_pagamento (object)
} (object) required
sales/get_v1_venda_by_id_imprimirGera e retorna um PDF da venda especificada pelo idid required
sales/post_v1_venda_exclusao_loteExclui vendas em lote máximo de 10 vendas por requisição especificadas pelos uuids fornecidosdata: {
. ids (array)
} (object) required
sales/get_v1_venda_by_id_venda_itensRetorna os itens de uma venda especificada pelo id da venda, com suporte a paginação e ordenaçãoid_venda (string) required
pagina (integer)
tamanho_pagina (integer)
sales/get_v1_venda_proximo_numeroRetornar o próximo número de venda disponívelNo parameters
customCall any endpoint of the connected service while reusing the connection auth. Pass the full URL as _url. Other reserved keys: _method, _query, _body, _headers. Remaining params flow naturally — empty → GET, non-empty → POST JSON body._url (string) required
_method (string)
_query (object)
_body
_headers (object)