ApiBrasil.Data.Dados (APIBrasil v0.0.1)

Copy Markdown View Source

Dados cadastrais device-based: POST /dados/{action}.

Além das funções nomeadas, request/4 aceita qualquer action do catálogo e queue/4 executa a mesma action por fila.

{:ok, envelope} = ApiBrasil.Data.Dados.cnpj(client, %{"cnpj" => "00000000000000"})
ApiBrasil.Core.DeviceResponse.response(envelope)

Para as mesmas consultas debitando créditos, veja ApiBrasil.Data.Consulta.

Summary

Functions

Consulta por filtros livres: POST /dados/byquery.

Como by_query/3, mas devolve o resultado direto e levanta ApiBrasil.Core.Error em caso de falha.

Consulta o capital social: POST /dados/capital-social.

Como capital_social/3, mas devolve o resultado direto e levanta ApiBrasil.Core.Error em caso de falha.

Consulta um CEP: POST /dados/cep.

Como cep/3, mas devolve o resultado direto e levanta ApiBrasil.Core.Error em caso de falha.

Consulta um CNPJ: POST /dados/cnpj — body %{"cnpj" => "..."}.

Como cnpj/3, mas devolve o resultado direto e levanta ApiBrasil.Core.Error em caso de falha.

Consulta um CPF: POST /dados/cpf — body %{"cpf" => "..."}.

Como cpf/3, mas devolve o resultado direto e levanta ApiBrasil.Core.Error em caso de falha.

Lista os CNAEs: POST /dados/lista-cnaes.

Como lista_cnaes/3, mas devolve o resultado direto e levanta ApiBrasil.Core.Error em caso de falha.

Lista os sócios de uma empresa: POST /dados/lista-socios.

Como lista_socios/3, mas devolve o resultado direto e levanta ApiBrasil.Core.Error em caso de falha.

Executa a action de forma assíncrona, por fila: POST /dados/{action}/queue.

Executa qualquer action do serviço: POST /dados/{action}.

Serviço do gateway coberto por este módulo: dados.

Types

result()

@type result() :: {:ok, map()} | {:error, ApiBrasil.Core.Error.t()}

Functions

by_query(client, body \\ nil, opts \\ [])

@spec by_query(ApiBrasil.Client.t(), term(), keyword()) ::
  {:ok, ApiBrasil.Core.DeviceResponse.t()} | {:error, ApiBrasil.Core.Error.t()}

Consulta por filtros livres: POST /dados/byquery.

by_query!(client, body \\ nil, opts \\ [])

Como by_query/3, mas devolve o resultado direto e levanta ApiBrasil.Core.Error em caso de falha.

capital_social(client, body \\ nil, opts \\ [])

@spec capital_social(ApiBrasil.Client.t(), term(), keyword()) ::
  {:ok, ApiBrasil.Core.DeviceResponse.t()} | {:error, ApiBrasil.Core.Error.t()}

Consulta o capital social: POST /dados/capital-social.

capital_social!(client, body \\ nil, opts \\ [])

@spec capital_social!(ApiBrasil.Client.t(), term(), keyword()) ::
  ApiBrasil.Core.DeviceResponse.t()

Como capital_social/3, mas devolve o resultado direto e levanta ApiBrasil.Core.Error em caso de falha.

cep(client, body \\ nil, opts \\ [])

Consulta um CEP: POST /dados/cep.

cep!(client, body \\ nil, opts \\ [])

Como cep/3, mas devolve o resultado direto e levanta ApiBrasil.Core.Error em caso de falha.

cnpj(client, body \\ nil, opts \\ [])

Consulta um CNPJ: POST /dados/cnpj — body %{"cnpj" => "..."}.

cnpj!(client, body \\ nil, opts \\ [])

Como cnpj/3, mas devolve o resultado direto e levanta ApiBrasil.Core.Error em caso de falha.

cpf(client, body \\ nil, opts \\ [])

Consulta um CPF: POST /dados/cpf — body %{"cpf" => "..."}.

cpf!(client, body \\ nil, opts \\ [])

Como cpf/3, mas devolve o resultado direto e levanta ApiBrasil.Core.Error em caso de falha.

lista_cnaes(client, body \\ nil, opts \\ [])

@spec lista_cnaes(ApiBrasil.Client.t(), term(), keyword()) ::
  {:ok, ApiBrasil.Core.DeviceResponse.t()} | {:error, ApiBrasil.Core.Error.t()}

Lista os CNAEs: POST /dados/lista-cnaes.

lista_cnaes!(client, body \\ nil, opts \\ [])

Como lista_cnaes/3, mas devolve o resultado direto e levanta ApiBrasil.Core.Error em caso de falha.

lista_socios(client, body \\ nil, opts \\ [])

@spec lista_socios(ApiBrasil.Client.t(), term(), keyword()) ::
  {:ok, ApiBrasil.Core.DeviceResponse.t()} | {:error, ApiBrasil.Core.Error.t()}

Lista os sócios de uma empresa: POST /dados/lista-socios.

lista_socios!(client, body \\ nil, opts \\ [])

Como lista_socios/3, mas devolve o resultado direto e levanta ApiBrasil.Core.Error em caso de falha.

queue(client, action_name, body \\ nil, opts \\ [])

Executa a action de forma assíncrona, por fila: POST /dados/{action}/queue.

queue!(client, action_name, body \\ nil, opts \\ [])

Como queue/4, mas levanta ApiBrasil.Core.Error em caso de falha.

request(client, action_name, body \\ nil, opts \\ [])

Executa qualquer action do serviço: POST /dados/{action}.

As actions conhecidas estão em ApiBrasil.Generated.Catalog.service_actions("dados"); a documentação completa fica em https://doc.apibrasil.io.

request!(client, action_name, body \\ nil, opts \\ [])

Como request/4, mas levanta ApiBrasil.Core.Error em caso de falha.

service()

@spec service() :: String.t()

Serviço do gateway coberto por este módulo: dados.