Atlassian uses cookies to improve your browsing experience, perform analytics and research, and conduct advertising. Accept all cookies to indicate that you agree to our use of cookies on your device. Atlassian cookies and tracking notice, (opens new window)
Este documento mostra todas as requisições e respostas esperadas em uma integração padrão de ERP e site de assinatura Datacake.
Exemplo de requisições GET, POST e PUT com payload e resposta esperadas em JSON para integração. Recomendamos autenticação com token no header da requisição
Request utilizada para pegar as informações do cliente no ERP com base no CPF/CNPJ dele
{
"cnpj_cpf": "" # Documento do cliente (cpf/cnpj)
}
{
"nome_completo": "", # Nome completo do cliente / razão social da empresa
"aniversario": "", # Data de aniversário do cliente
"data_registro": "", # Data de cadastro do cliente no ERP
"ativo": "", # Cliente está ativo no ERP
"id_remoto": "", # ID do cliente dentro do ERP
"id_contrato": "", # ID do contrato do cliente
"rua_endereco": "", # Nome da rua do endereço do cliente
"numero_endereco": "", # Número da casa do endereço do cliente
"cep_endereco": "", # Cep do endereço do cliente
"cidade_endereco": "", # Cidade do endereço do cliente
"complemento_endereco": "", # Complemento do endereço do cliente
"bairro_endereco": "", # Bairro do endereço do cliente
"estado_endereco": "" # Estado do endereço do cliente
}
Request utilizada para listar os boletos dos clientes com base no documento do cliente (cpf/cnpj)
{
"document": "" # Documento do cliente (cpf/cnpj)
"id_contrato": "", # ID do contrato do cliente
}
{
[
{
"id_fatura": "", # ID utilizado para identificação e baixa de Fatura
"code_fatura": "", # Valor composto pelo ID da fatura e docuemento do cliente
"nome_cliente": "", # Nome do Cliente
"document_number": "", # Documento do cliente, o mesmo informado para obter as faturas
"remote_id": "", # Código do cliente no ERP
"valor_inicial": "", # Valor original do Boleto
"valor_atual": "", # Valor atualizado na data da Consulta
"juros": "", # Juros aplicado ao boleto na data de consulta
"multa": "", # Multa aplicado ao boleto na data de consulta
"desconto": "", # Desconto aplicado ao boleto na data de consulta
"data_emissao": "", # Data de emissão do Boleto
"data_vencimento": "", # Data de vencimento do Boleto
"historico": "", # Mensagem de referência da Fatura (ex. Mensalidade Plano X)
"bank_code": "", # Codigo que indica a qual banco pertence a fatura
"linha_digitavel": "", # Linha digitavel do Boleto
"integration_id": "", # Id da integraçõ ERP a qual o boleto pertence
"identifier": "", # Identificador de pagamento (Ex. Carteira de cobrança)
"pix_code": "", # Código PIX copia e cola de sistema de pagamento do ERP
"contract_id": "" # Id do contrado(s) a qual pertence a Fatura
"bill_receipt": "", # Cabeço de impressão gerado para o Totem (TEF)
"bill_pix_receipt": "", # Cabeço de impressão gerado para o Totem (PIX)
}
]
}
APPTOTEMBoleto Pegar Contratos do Cliente (GET):
Request utilizado para listar o contratos do cliente. Utilizado para listar os boletos por contrato. Para pleno funcionamento, ID do contrato deverá ser enviado junto ao response que lista fatura abertas.
{
"document": "" # Documento do cliente (cpf/cnpj)
}
{
"remote_id": "", # Id do Contrato no ERP. Utilizado para filtrar o boletos
"contract_name": "" # Endereço da instalação
}
APP Pegar notas fiscais (GET):
Request utilizada para listar as notas fiscais emitidas para um cliente
{
"document": "" # Documento do cliente (cpf/cnpj)
"id_cliente": "" # ID do cliente no ERP
}
{
[
{
"id_nota": "", # ID da nota fiscal dentro do ERP
"id_tipo_nota: "", # ID do tipo da nota fiscal dentro do ERP
"numero_nota": "", # Número da nota fiscal
"valor": "", # Valor da nota fiscal
"protocolo": "", # Protocolo da nota fiscal
"data_lancamento": "", # Data que a nota foi lançada no ERP
"identificacao": "", # Identificação da nota fiscal
"url_nota_fiscal": "", # Url do pdf da nota fiscal
}
]
}
APP Pegar extratos financeiros (GET):
Request utilizada para listar os extratos financeiros de um cliente
{
"document": "" # Documento do cliente (cpf/cnpj)
"id_cliente": "" # ID do cliente no ERP
}
{
[
{
"id_nota": "", # ID da fatura
"data_lancamento": "", # Data de lançamento da fatura
"data_vencimento": "", # Data de vencimento da fatura
"data_baixa": "", # Data da baixa da fatura
"historico": "", # Histórico da fatura
"valor": "", # Valor recebido da fatura
"saldo": "", # Valor da fatura
"cobranca": "", # Descrição da cobrança
}
]
}
APP Pegar declaração de quitação de débitos (GET):
Request utilizada para listar as declarações de quitação de débito de um cliente
{
"document": "" # Documento do cliente (cpf/cnpj)
"id_cliente": "" # ID do cliente no ERP
}
{
[
{
"id_quitacao": "", # ID da quitação de débito
"ano": "", # Ano referente a quitação de débito
"valor": "", # Valor total da quitação de débito
"url_arquivo": "" # URL do pdf da quitação de débito
}
]
}
APP Pegar instalações/produtos de um cliente (GET):
Request para listar todos os produtos/instalações/serviços de um cliente
{
"document": "" # Documento do cliente (cpf/cnpj)
"id_cliente": "" # ID do cliente no ERP
}
{
[
{
"id_servico": "", # ID do serviço no ERP
"nome": "", # Nome do serviço
"situacao": "", # Situação do serviço no ERP (ativo, suspenso, etc.)
"obs": "", # Observações/comentários sobre o serviço
"valor": "", # Valor do serviço
"numero_plano": "", # Número/posição do serviço no ERP
"endereco": "", # Endereço referente ao serviço do cliente
}
]
}
PROSPECTOLEADTOTEM Pegar todos os produtos (GET):
Request utilizada para listar todos os produtos disponíveis no sistema. Isso é utilizado para mapear o produto do eCommerce, assim o prospecto/lead já é criado com um vínculo aos produtos
{}
{
[
{
"id_servico": "", # ID do produto/serviço no ERP
"nome": "", # Nome de apresentação do produto
"descricao": "", # Descrição do produto
"valor": "", # Valor do produto
"obs": "" # Observações
}
]
}
PROSPECTOLEADTOTEM Pegar todos os revendedores (GET):
Request utilizada para listar todos os revendedores, Isso é utilizado para mapear os revendedores no eCommerce, assim as vendas dos mesmos podem ser vinculados a eles nos relatórios e os prospectos/leads já são criados com o vínculo do revendedor que realizou a venda/captação
{}
{
[
{
"id_revendedor": "", # ID do revendedor no ERP
"nome": "", # Nome do revendedor
"documento": "", # Documento do revendedor (CPF/CNPJ)
"email": "", # Email do revendedor
"obs": "" # Observações
}
]
}
APPPROSPECTOTOTEM Pegar todos os funcionários (GET):
Request utilizada para listar todos os funcionários, Isso é utilizado para direcionar os atendimentos gerados pelo eCommerce/App caso eles sejam vinculados com um funcionário
{}
{
[
{
"id_funcionario": "", # ID do funcionário no ERP
"nome": "", # Nome do funcionário
"obs": "" # Observações
}
]
}
APP Pegar todos os departamentos (GET):
Request utilizada para listar todos os departamentos, Isso é utilizado para direcionar os atendimentos gerados pelo eCommerce/App caso eles sejam vinculados com um departamento
{}
{
[
{
"id_departamento": "", # ID do departamento no ERP
"nome": "", # Nome do departamento
"obs": "" # Observações
}
]
}
PROSPECTOTOTEM Pegar todos os vencimentos (GET):
Request utilizada para listar os vencimentos, isso é utilizado para que os prospectos sejam criados com o vencimento vinculado corretamente
{}
{
[
{
"id_vencimento": "", # ID do vencimento no ERP
"data": "", # "Nome" da data de vencimento (Exemplo: "dia 5")
"obs": "" # Observações
}
]
}
PROSPECTOLEADTOTEM Pegar as origens comerciais (GET):
Request utilizada para listar as origens comerciais, isso é utilizado para que os prospectos sejam criados com a origem comercial vinculada corretamente. (Ex. Google, Outdoor, Indicação de Amigo, Anúncio de Rádio)
{}
{
[
{
"id_origem": "", # ID da origem comercial no ERP
"nome": "", # Nome da origem comercial
"obs": "" # Observações
}
]
}
PROSPECTOLEADTOTEM Pegar todas as cidades (GET):
Request utilizada para listar as cidades cadastradas no sistema, isso é utilizado pois muitos sistemas utilizam um código proprietário para a cidade. assim os prospectos são criados com a cidade vinculada corretamente.
{}
{
[
{
"id_cidade": "", # ID da cidade no ERP
"nome": "", # Nome da cidade no ERP
"latitude": "", # Latitude da cidade
"longitude": "", # Longitude da cidade
"obs": "" # Observações
}
]
}
APP Pegar todos os tipos de atendimentos (GET):
Request utilizada para listar todos os tipos de atendimentos, Isso é utilizado para que os atendimentos criados pelo eCommerce/App caiam no sistema com o tipo correto
{}
{
[
{
"id_tipo_de_atendimento": "", # ID do tipo de atendimento no ERP
"nome": "", # Nome do tipo de atendimento no ERP
"obs": "" # Observações
}
]
}
PROSPECTOTOTEM Pegar todos os status de prospectos (GET):
Request utilizada para listar os status de prospectos, isso é utilizado para classificar os prospectos conformes eles são criados e para atualizar os prospectos durante a automação. (Ex. Inicial, Em analise, Reprovado, Suspenso, Aprovado, Cancelado)
{}
{
[
{
"status_prospeccao": "", # Código do status no ERP
"nome": "", # Nome do status no ERP
"obs": "" # Observações
}
]
}
PROSPECTOTOTEM Criar prospectos (POST):
Request utilizada para a criação de uma prospecção no sistema, esse é o principal canal de entrada de novas assinaturas.
Se for necessário o EPR deve informar todos APIs necessárias para criar um pedido no sistema integrado com o maior numero das informações possível.
Se for o caso pode-se fracionar o em varias APIs para chegar ao resultado final, exemplo: API para cadastro de Prospecto/Cliente, API para cadastro de endereço, APi para upload de arquivos no prospecto, etc.
{
"nome": "", # Nome do Cliente ou Responsavel pela Empresa
"razão_social": "", # Razão do social para clientes PJ (Opcional)
"tipo_pessoa": "", # Tipo da pessoa, Física ou Juridica
"cnpj_cpf": "", # CPF ou CNPJ do cliente
"ie_identidade": "", # Inscrição Estadual parra clientes PJ (Opcional)
"data_nascimento": "", # Data de nascimento do cliente ou do responsável
"id_revendedor": "", # Id do revendedor
"id_origem": "", # Id da Origem comercial
"id_vencimento": "", # Id do Vencimento no ERP
"cep": "", # CEP do cliente
"endereco_instalação": "", # Logradouro do endereço de instalação
"numero_instalação": "", # Numero do endereço de instalação
"bairro_instalação": "", # Bairro do endereço de instalação
"cidade_instalação": "", # Cidade do endereço de instalação
"complemento_instalação": "", # Complemento do endereço de instalação
"referencia_instalação": "", # Referencia do endereço de instalação
"uf_instalação": "", # Estado do endereço de instalação
"endereco_cobranca": "", # Logradouro do endereço de cobrança
"numero_cobranca": "", # Numero do endereço de cobrança
"bairro_cobranca": "", # Bairro do endereço de cobrança
"cidade_cobranca": "", # Cidade do endereço de cobrança
"complemento_cobranca": "", # Complemento do endereço de cobrança
"referencia_cobranca": "", # Referencia do endereço de cobrança
"uf_cobranca": "", # Estado do endereço de cobrança
"latitude": "", # Latitude da instalação
"longitude": "", # Longitude da instalação
"telefone": "", # Telefone residencial
"celular": "", # Celular
"celular_extra": "", # Celular extra (geralmente whatsapp)
"email": "", # Email
"obs": "", # Resumo de todas as informações do pedido
"servicos": [ # Array serviços contratados/interesse
{
"id_servico" # ID do serviço no ERP
}
],
"anexos": [ # Array de anexos dos documentos anexados ao pedido
{
"nome_documento": "", # Nome do documento
"formato": "", # Formato do arquivo
"base_64" "" # Conteúdo do arquivo em base 64
}
]
}
{
"id_prospecto": "", # Id do Prospecto retornado do ERP
"obs": "" # Observação ou menssagem do ERP
}
LEADTOTEM Criar lead (POST):
Request utilizada para a criação de um lead no sistema, esse é como você irá registrar clientes que tem a intenção de assinar no futuro ou que ainda não estão cobertos pelos seus serviços/produtos.
Dados podem varia conforme formulário do pre-checkout
{
"nome": "", # Nome do cliente
"documento": "", # Documento do cliente
"email": "", # Email do cliente
"telefone": "", # Telefone do cliente
"endereco": "", # Logradouro do endereço de instalação
"numero": "", # Numero do endereço de instalação
"bairro": "", # Bairro do endereço de instalação
"cidade": "", # Cidade do endereço de instalação
"estado": "", # Estado do endereço de instalação
"CEP": "", # CEP do endereço de instalação
"cobertura": "", # JSON com dados da Cobertura
"latitude": "", # Latitude da instalação
"longitude": "", # Longitude da instalação
"revendedor": "", # Nome do revendedor
"id_revendedor": "", # ID do revendedor no ERP
"extra_data": "" # Dados extras do lead
}
{
"id_lead": "", # ID do lead retornado do ERP
"obs": "" # Observação ou menssagem do ERP
}
APP Criar atendimento (POST):
Request utilizada para criar um atendimento/chamado/ajuda com a possibilidade de enviar um anexo em formato Base64
{
"id_cliente": "", # ID do cliente no ERP
"id_servico": "", # ID do serviço do cliente no ERP
"id_tipo_de_atendimento": "", # ID do tipo de atendimento escolhido pelo cliente no ERP
"id_departamento": "", # ID do departamento escolhido pelo cliente no ERP
"id_funcionario": "", # ID do funcionário responsável no ERP
"email": "", # Email do cliente
"telefone": "", # Telefone do cliente
"assunto": "", # Assunto do chamado que o cliente esta abrindo
"mensagem": "", # Mensagem do chamado que o cliente esta abrindo
"anexo": [ # Anexos enviados pelo cliente (se a opção estiver liberada)
{
"anexo": "", # Conteúdo do arquivo em base 64
"obs": "", # Observação do anexo
"nome_anexo": "" # Nome do anexo
}
]
}
{
"id_atendiemnto": "", # ID do lead retornado do ERP
"obs": "" # Observação ou menssagem do ERP
}
APPTOTEMBoleto Habilitação provisória (POST):
Request utilizada para habilitar provisoriamente um serviço suspenso geralmente por falta de pagamento. também conhecido como ativação de confiança
{
"id_cliente": "", # ID do cliente no ERP
"id_servico": "", # ID do serviço do cliente no ERP
}
{
"status": "", # Status do serviço após a chamada de ativação (se foi ativo ou não)
}
ProspectoTOTEM Edição do prospecto (PUT):
Request utilizada para atualizar uma prospecção conforme a automação acontece. Nem todos os campos são necessariamente editados/atualizados
{
"id_prospecto": "", # ID do prospecto no ERP
"status_prospeccao": "", # ID do status do prospecto no ERP
"id_revendedor": "", # ID do revendedor do ERP
"obs": "", # Observações
}
{
"status": "", # Status atual do prospecto no ERP
}
APP Edição do cliente (PUT):
Request utilizada para atualizar as informações de um cliente. Geralmente atualiza-se apenas as informações de contato (email, telefone, WhatsApp)
{
"id_cliente": "", # ID do cliente no ERP
"nome": "", # Nome do cliente no ERP
"fantasia": "", # Nome fantasia do cliente para empresa
"tipo_pessoa": "", # Tipo da pessoa, Física ou Juridica
"cnpj_cpf": "", # CPF ou CNPJ do cliente
"ie_identidade": "", # Inscrição Estadual parra clientes PJ (Opcional)
"rg_orgao_emissor": "", #
"inscricao_municipal": "", #
"contribuinte_icms": "", #
"nacionalidade": "", #
"cidade_naturalidade": "", #
"estado_nascimento": "", #
"data_nascimento": "", #
"estado_civil": "", #
"ativo": "", #
"Sexo": "", #
"profissao": "", #
"data_cadastro": "", #
"cep": "", #
"endereco": "", #
"numero": "", #
"complemento": "", #
"bairro": "", #
"cidade": "", #
"uf": "", #
"latitude": "", #
"longitude": "", #
"fone": "", #
"telefone_comercial": "", #
"telefone_celular": "", #
"whatsapp": "", #
"email": "", #
"obs": "", #
"alerta": "" #
}
{
"status": "",
}
ProspectoTOTEM Envio de arquivos (POST)
Request utilizada para enviar arquivos anexados pelos clientes na hora da assinatura, de modo a deixar os arquivos vinculados aos prospectos/leads. Os arquivos são enviados em Base64, geralmente imagens (jpg, png, gif) ou PDF
APPTOTEMBoleto Baixa na fatura/Sinalização de pagamento (POST)
Request utilizada para sinalizar ao ERP que a fatura em questão do cliente foi paga pelo terminal de atendimento da Datacake (Totem) ou pelo aplicativo; permitindo o ERP marcar a mesma como paga e caso necessário retomar os serviços suspensos