Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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

Índice
minLevel1
maxLevel7
outlinetrue

Estado
titleAPP
Estado
colourYellow
titleTOTEM
Estado
colourGreen
titleBoleto
Pegar infos de clientes (GET):

Request utilizada para pegar as informações do cliente no ERP com base no CPF/CNPJ dele

Expandir
titlePayload
Bloco de código
languagejson
{
  "cnpj_cpf": ""  # Documento do cliente (cpf/cnpj)
}
Expandir
titleResponse
Bloco de código
languagejson
{
    "idnome_clientecompleto": "",      "nome": "",     "fantasia": "",
    "tipo_pessoa": "",# Nome completo do cliente / razão social da empresa
    "cnpj_cpfaniversario": "",     "ie_identidade": "",     "rg_orgao_emissor": "",  # Data de  "inscricao_municipal": "",aniversário do cliente
    "contribuintedata_icmsregistro": "N",     "nacionalidade": "",       "cidade_naturalidade": "",
    "estado_nascimento": "",# Data de cadastro do cliente no ERP
    "data_nascimentoativo": "",      "estado_civil": "",     "ativo": "",     "Sexo": "", # Cliente está ativo "profissao": "",no ERP
    "dataid_cadastroremoto": "",         "cep": "",     "endereco": "",
    "numero": "", # ID do cliente dentro do ERP
    "complementoid_contrato": "",     "bairro": "",       "cidade": "", # ID do contrato "uf": "",do cliente
    "latituderua_endereco": "",     "longitude": "",     "fone": "", # Nome da  "telefone_comercial": "",rua do endereço do cliente
    "telefonenumero_celularendereco": "",     "whatsapp": "",     # Número da "email": "",
    "obs": "",
    "alerta": ""
}

Pegar boletos abertos/faturas (GET):

Request utilizada para listar os boletos dos clientes com base id do cliente

Expandir
titlePayload
Bloco de código
languagejson
{
    "id_cliente": ""
}
Expandir
titleResponse
Bloco de código
languagejson
{casa do endereço do cliente
    "cep_endereco": "",     [        # {Cep do endereço do cliente
      "idcidade_faturaendereco": "",          # Cidade  "nome_cliente": "",  
     do endereço do cliente
    "valorcomplemento_inicialendereco": "",     # Complemento do endereço do cliente
    "valorbairro_atualendereco": "",          # Bairro  "data_emissao": "",  
  do endereço do cliente
       "dataestado_vencimentoendereco": "",           #  "linha_digitavel": "",  
          "url_boleto": ""
        }
    ]
}

...

Estado do endereço do cliente
}

Estado
titleAPP
Estado
colourYellow
titleTOTEM
Estado
colourGreen
titleBoleto
Pegar boletos abertos/faturas (GET):

Request utilizada para listar as notas fiscais emitidas de um clienteos boletos dos clientes com base no documento do cliente (cpf/cnpj)

Expandir
titlePayload
Bloco de código
languagejson
{
    "id_clientedocument": "" }
Expandir
title
     # Documento do cliente (cpf/cnpj)
    "id_contrato": "",  # ID do contrato do cliente
}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "id_notafatura": "",        # ID utilizado para identificação e baixa "status": "",de Fatura 
             "valor"code_fatura": "",      # Valor composto pelo ID da fatura e  "valor_pago": "",docuemento do cliente  
            "datanome_lancamentocliente": "",     # Nome do Cliente
          "datadocument_vencimentonumber": "",  # Documento do cliente, o mesmo informado para obter as faturas
          "dataremote_baixaid": "",        # Código do cliente no ERP
          "urlvalor_nota_fiscalinicial": "",    # Valor original do Boleto
    }     ]
}

Pegar extratos financeiros (GET):

Request utilizada para listar os extratos financeiros

Expandir
titlePayload
Bloco de código
languagejson
{ "valor_atual": "",     "id_cliente": ""
}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        { # Valor atualizado na data da Consulta
             "id_extrato_financeiro"juros": "",            # Juros aplicado ao boleto na "data_lancamento": "",
 de consulta
           "data_vencimentomulta": "",            # Multa  "data_baixa": "",  
 aplicado ao boleto na data de consulta
          "id_boletodesconto": "",         # Desconto aplicado  "id_nota": "",
 ao boleto na data de consulta
          "valordata_emissao": "",     # Data de emissão do  Boleto
 "valor_pago": "",             "multa"data_vencimento": "",  # Data de vencimento do Boleto
          "juroshistorico": "",        # Mensagem de referência da "desconto": "",
 Fatura (ex. Mensalidade Plano X)
          "obsbank_code": "",        # Codigo que indica  }a qual banco pertence a fatura
    ] }

Pegar declaraçao de quitação de débitos (GET):

Request utilizada para listar as declarações de quitação de débito de um cliente

Expandir
titlePayload
Bloco de código
languagejson
{     "idlinha_clientedigitavel": ""
}
Expandir
titleResponse
Bloco de código
languagejson
{,  # Linha digitavel do Boleto
           ["integration_id": "",   # Id da integraçõ ERP a qual {o boleto pertence
          "id_quitacaoidentifier": "",       # Identificador de pagamento (Ex. Carteira de cobrança)
   "ano       "pix_code": "",         # Código PIX copia e cola "valor": "",  
 de sistema de pagamento do ERP
          "urlcontract_arquivoid": ""       #  }Id do contrado(s) a qual pertence a Fatura
    ] }

Pegar instalações/produtos de um cliente (GET):

Request para listar todos os produtos/instalações de um cliente

Expandir
titlePayload
Bloco de código
languagejson
{     "idbill_clientereceipt": ""
}
Expandir
titleResponse
Bloco de código
languagejson
{,     [# Cabeço de impressão gerado para o Totem (TEF)
{             "id_instalacao"bill_pix_receipt": "", # Cabeço de impressão gerado para o Totem (PIX)
     "cep": "",  }
          "endereco": "",
     ]
}

Estado
titleAPP
Estado
colourYellow
titleTOTEM
Estado
colourGreen
titleBoleto
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.

Expandir
titlePayload
Bloco de código
languagejson
{
      "numerodocument": "",  # Documento do cliente   (cpf/cnpj)
}
Expandir
titleResponse
Bloco de código
languagejson
{
    "complementoremote_id": "",      # Id do Contrato no ERP. Utilizado "bairro": "",
 para filtrar o boletos
          "cidade"contract_name": "",   # Endereço da   instalação
}

Estado
titleAPP
Pegar notas fiscais (GET):

Request utilizada para listar as notas fiscais emitidas para um cliente

Expandir
titlePayload
Bloco de código
languagejson
{
    "ufdocument": "",    # Documento do cliente (cpf/cnpj)
    "latitudeid_cliente": "",  # ID do cliente no       "longitude": "",ERP
}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
       "obs": "", {
            "servicosid_nota": ["",              # ID da {nota fiscal dentro do ERP
                "id_servico"tipo_nota: "",          # ID do tipo da nota fiscal dentro do ERP
 "nome": "",          "numero_nota": "",          "descricao": "",
  # Número da nota fiscal
                 "valor": "",                # Valor da nota fiscal
            "statusprotocolo": "",            # Protocolo da nota fiscal
    "obs        "data_lancamento": "",      # Data que a nota foi lançada no ERP  
}            "identificacao": "",     ]
    # Identificação da nota fiscal
      }     ]
}

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

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{ "url_nota_fiscal": "",     [ # Url do pdf da nota  fiscal {
        }
   "id_servico": "",
      ]
}

Estado
titleAPP
Pegar extratos financeiros (GET):

Request utilizada para listar os extratos financeiros de um cliente

Expandir
titlePayload
Bloco de código
languagejson
{
      "nomedocument": "",    # Documento do cliente (cpf/cnpj)
    "descricaoid_cliente": "",  # ID do cliente no ERP
}
Expandir
titleResponse
Bloco de código
languagejson
{
    "valor": "",[
        {
    "obs": ""         }
    ]
}

Pegar todos os revendedores (GET):

...

"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
        }
    ]
}

Estado
titleAPP
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

Expandir
titlePayload
Bloco de código
languagejson
{
    "document": ""    # Documento do cliente (cpf/cnpj)
    "id_cliente": ""  # ID do cliente no ERP
}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "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
        }
    ]
}

Estado
titleAPP
Pegar instalações/produtos de um cliente (GET):

Request para listar todos os produtos/instalações/serviços de um cliente

Expandir
titlePayload
Bloco de código
languagejson
{
    "document": ""    # Documento do cliente (cpf/cnpj)
    "id_cliente": ""  # ID do cliente no ERP
}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "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
        }
    ]
}

Estado
colourPurple
titlePROSPECTO
Estado
colourRed
titleLEAD
Estado
colourYellow
titleTOTEM
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

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "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
        }
    ]
}

Estado
colourPurple
titlePROSPECTO
Estado
colourRed
titleLEAD
Estado
colourYellow
titleTOTEM
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

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "id_revendedor": "",  # ID do revendedor no ERP
            "nome": "",           # Nome do revendedor
            "documento": "",      # Documento do revendedor (CPF/CNPJ)
            "email": "",          # Email do revendedor
            "obs": ""             # Observações
        }
    ]
}

Estado
titleAPP
Estado
colourPurple
titlePROSPECTO
Estado
colourYellow
titleTOTEM
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

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "id_funcionario": "",   # ID do funcionário no ERP
            "nome": "",             # Nome do funcionário
            "obs": ""               # Observações
        }
    ]
}

Estado
titleAPP
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

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "id_departamento": "",    # ID do departamento no ERP
            "nome": "",               # Nome do departamento
            "obs": ""                 # Observações
        }
    ]
}

Estado
colourPurple
titlePROSPECTO
Estado
colourYellow
titleTOTEM
Pegar todos os vencimentos (GET):

Request utilizada para listar os vencimentos, isso é utilizado para que os prospectos sejam criados com o vencimento vinculado corretamente

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "id_vencimento": "",    # ID do vencimento no ERP
            "data": "",             # "Nome" da data de vencimento (Exemplo: "dia 5")
            "obs": ""               # Observações
        }
    ]
}

Estado
colourPurple
titlePROSPECTO
Estado
colourRed
titleLEAD
Estado
colourYellow
titleTOTEM
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)

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "id_origem": "",    # ID da origem comercial no ERP
            "nome": "",         # Nome da origem comercial
            "obs": ""           # Observações
        }
    ]
}

Estado
colourPurple
titlePROSPECTO
Estado
colourRed
titleLEAD
Estado
colourYellow
titleTOTEM
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.

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "id_cidade": "",    # ID da cidade no ERP
            "nome": "",         # Nome da cidade no ERP
            "latitude": "",     # Latitude da cidade
            "longitude": "",    # Longitude da cidade
            "obs": ""           # Observações
        }
    ]
}

Estado
titleAPP
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

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "id_tipo_de_atendimento": "",   # ID do tipo de atendimento no ERP
            "nome": "",                     # Nome do tipo de atendimento no ERP
            "obs": ""                       # Observações
        }
    ]
}

Estado
colourPurple
titlePROSPECTO
Estado
colourYellow
titleTOTEM
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)

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
            "status_prospeccao": "",    # Código do status no ERP
            "nome": "",                 # Nome do status no ERP
            "obs": ""                   # Observações
        }
    ]
}

Estado
colourPurple
titlePROSPECTO
Estado
colourYellow
titleTOTEM
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.

Expandir
titlePayload
Bloco de código
languagejson
{
    "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
        }
    ]
}
Expandir
titleResponse
Bloco de código
languagejson
{
    "id_prospecto": "",      # Id do Prospecto retornado do ERP
    "obs": ""                # Observação ou menssagem do ERP
}

Estado
colourRed
titleLEAD
Estado
colourYellow
titleTOTEM
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

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
"nome": "",        {   # Nome do cliente
      "id_revendedordocumento": "",      # Documento do cliente
    "nomeemail": "",          # Email do "obs": ""cliente
         }
    ]
}

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

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {
       "telefone": "",       # Telefone do cliente
    "endereco": "",       # Logradouro do endereço de instalação
    "id_funcionarionumero": "",,         # Numero do endereço de instalação
    "nomebairro": "",         # Bairro do endereço de instalação
    "obscidade": "",         }
    ]
}

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

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
    [
        {# Cidade do endereço de instalação
    "estado": "",         # Estado do endereço de instalação
    "id_departamentoCEP": "",            # CEP "nomedo endereço de instalação
    "cobertura": "",      # JSON com dados da Cobertura
    "obslatitude": "",       # Latitude da instalação
    "longitude": "",      # Longitude }da instalação
   ]
}

Pegar todos os vencimentos (GET):

Request utilizada para listar os vencimentos, isso é utilizado para que os prospectos sejam criados com o vencimento vinculado corretamente

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{ "revendedor": "",     [# Nome do revendedor
     {"id_revendedor": "",  # ID do revendedor no ERP
     "idextra_vencimentodata": "",      # Dados extras do lead
}
Expandir
titleResponse
Bloco de código
languagejson
{
    "dataid_lead": "",  # ID do lead retornado do ERP
    "obs": ""       # Observação }ou menssagem do ERP
 ]
}

...

Estado
titleAPP
Criar atendimento (POST):

Request utilizada para listar as origens comerciáis, isso é utilizado para que os prospectos sejam criados com a origem comercial vinculada corretamente. (Ex. Google, Outdoor, Indicação de Amigo, Anuncio de Rádio)criar um atendimento/chamado/ajuda com a possibilidade de enviar um anexo em formato Base64

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{
 
    "id_cliente": "",   [         {     # ID do cliente no ERP
    "id_origemservico": "",               "nome": "", # ID do serviço do cliente no ERP
    "obsid_tipo_de_atendimento": "",     # ID do  }
tipo de atendimento escolhido pelo cliente no ERP
   ]
}

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.

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{ "id_departamento": "",     [       # ID {do departamento escolhido   pelo cliente no ERP
    "id_cidadefuncionario": "",             "nome": "",
       # ID do funcionário responsável no ERP
    "latitudeemail": "",             "longitude": "",         # Email do cliente
    "obstelefone": "",         }          ]
}

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 sejam do tipo correto utilizado

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{# Telefone do cliente
    "assunto": "",           [         {# Assunto do chamado que o cliente esta abrindo
    "id_tipo_de_atendimentomensagem": "",                   # Mensagem do chamado que o cliente esta abrindo
    "nomeanexo": "",[             "obs": ""         } # Anexos enviados pelo ]
}

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)

Expandir
titlePayload
Bloco de código
languagejson
{}
Expandir
titleResponse
Bloco de código
languagejson
{cliente (se a opção estiver liberada)
        {
            "anexo": "",           [   # Conteúdo do arquivo em base {64
            "status_prospeccaoobs": "",,                # Observação do anexo
            "nome_anexo": "",          # Nome  "obs": ""do anexo
        }
    ]
}

...

Request utilizada para a criação de uma prospecção no sistema, esse é o principal canal de entrada de novas assinaturas

Expandir
titlePayloadResponse
Bloco de código
languagejson
{
    "nomeid_atendiemnto": "",   # ID do lead  "nome_fantasia": "",retornado do ERP
    "status_prospeccaoobs": "status_prospeccao",     "tipo_pessoa": "",     "cnpj_cpf": "",     "ie_identidade": "",
    "data_nascimento": "",# Observação ou menssagem do ERP
}

Estado
titleAPP
Estado
colourYellow
titleTOTEM
Estado
colourGreen
titleBoleto
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

Expandir
titlePayload
Bloco de código
languagejson
{
    "dataid_cadastrocliente": "",   #  "id_revendedor": "id_revendedor",
    "id_origem": "id_origem",
    "id_vencimentoID do cliente no ERP
    "id_servico": "id_vencimento",   # ID "cep": "",
    "endereco": "",do serviço do cliente no ERP
}
Expandir
titleResponse
Bloco de código
languagejson
{
     "numerostatus": "",   # Status "bairro": "",
    "cidade": "",
    "id_cidade": "id_cidade",do serviço após a chamada de ativação (se foi ativo ou não)
}

Estado
colourPurple
titleProspecto
Estado
colourYellow
titleTOTEM
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

Expandir
titlePayload
Bloco de código
languagejson
{
    "complementoid_prospecto": "",     "referencia": "",     "uf": "",
    "latitude": "",# ID do prospecto no ERP
      "longitudestatus_prospeccao": "",     "fone": "",
    "telefone_comercial": "", # ID do status do prospecto no ERP
    "telefoneid_celularrevendedor": "",
    "whatsapp": "",     "ramal": "",     "email": "", # ID do revendedor "obs": "",do ERP
    "alertaobs": "",     "servicos": [         {     # Observações
}
Expandir
titleResponse
Bloco de código
languagejson
{
     "id_servicostatus": "",   # Status atual      }
    ]
}do prospecto no ERP
}

Estado
titleAPP
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)

Expandir
titleResponsePayload
Bloco de código
languagejson
{
    "id_prospectocliente": "",         "obs": ""
}

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

Expandir
titlePayload
Bloco de código
languagejson
{    # ID do cliente no ERP
    "nome": "",       "nome_fantasia": "",            # Nome do cliente no ERP
    "tipo_pessoafantasia": "",     "cnpj_cpf": "",         "ie_identidade": "",
    "data_nascimento": "", # Nome fantasia do cliente para empresa
    "datatipo_cadastropessoa": "",       "id_revendedor": "id_revendedor",     # Tipo "cep": "",
da pessoa, Física ou Juridica
    "enderecocnpj_cpf": "",     "numero": "",        "bairro": "", # CPF ou CNPJ "cidade": "",do cliente
    "idie_cidadeidentidade": "id_cidade",     "complemento": "",     "referencia": "",
    "uf": "",# Inscrição Estadual parra clientes PJ (Opcional)
    "latituderg_orgao_emissor": "",      "longitude": "", # 
    "foneinscricao_municipal": "",    # "telefone_comercial":
"",     "telefonecontribuinte_celularicms": "",      "whatsapp": "",# 
    "ramalnacionalidade": "",     "email": "",     "obs": "",# 
    "alertacidade_naturalidade": "",    # "servicos":
[         {"estado_nascimento": "",        # 
    "iddata_serviconascimento": "",         }# 
   ] }
Expandir
titleResponse
Bloco de código
languagejson
{
    "id_lead"estado_civil": "",     "obs": ""
}

Criar atendimento (POST):

Request utilizada para criar um atendimento/chamado/ajuda com a possibilidade de enviar um anexo em formato Base64

Expandir
titlePayload
Bloco de código
languagejson
{      # 
    "id_clienteativo": "id_cliente",               "id_servico   # 
    "Sexo": "id_servico",      "id_tipo_de_atendimento             # 
    "profissao": "id_tipo_de_atendimento",          "id_departamento": "id_departamento",    # 
    "iddata_funcionariocadastro": "id_funcionario",          # 
    "emailcep": "",              "telefone": "",     "assunto": "",# 
    "mensagemendereco": "",        "obs": "",       "alerta": "",# 
    "anexonumero": "", [         {       # 
    "anexocomplemento": B64_DO_ARQUIVO,"",            # 
    "obsbairro": "",             "nome_anexo": ""   # 
    }
"cidade": "",    ] }
Expandir
titleResponse
Bloco de código
languagejson
{     "id_atendiemnto": "",     "obs": ""
}

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

Expandir
titlePayload
Bloco de código
languagejson
{ # 
    "id_clienteuf": "id_cliente",            "id_servico": "id_servico", }
Expandir
titleResponse
Bloco de código
languagejson
{     "status": "",
}

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

Expandir
titlePayload
Bloco de código
languagejson
{ # 
    "id_prospectolatitude": "",               # 
 "status_prospeccao   "longitude": "status_prospeccao",      "id_revendedor        # 
    "fone": "id_revendedor",      "obs": "",            "alerta": "",
}
Expandir
titleResponse
Bloco de código
languagejson
{ # 
    "statustelefone_comercial": "",
}

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)

Expandir
titlePayload
Bloco de código
languagejson
{     # 
    "idtelefone_clientecelular": "",       # 
    "nomewhatsapp": "",          "fantasia": "",     # 
    "tipo_pessoaemail": "",     "cnpj_cpf": "",       "ie_identidade": "",     "rg_orgao_emissor": "",# 
    "inscricao_municipalobs": "",     "contribuinte_icms": "N",     "nacionalidade": "",     "cidade_naturalidade": "",     "estado_nascimento": "",# 
    "data_nascimentoalerta": "",       "estado_civil": "",     "ativo": "",    # "Sexo": "",
}
Expandir
titleResponse
Bloco de código
languagejson
{
    "profissaostatus": "",
    "data_cadastro": "",
    "cep": "",
    "endereco": "",}

Estado
colourPurple
titleProspecto
Estado
colourYellow
titleTOTEM
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

Expandir
titlePayload
Bloco de código
languagejson
{
    "numeroid_prospecto": "",
    "complementonome_arquivo": "",
    "bairroarquivo": "",
    "cidadeobs": "",
    "uf": "",}
Expandir
titleResponse
Bloco de código
languagejson
{
    "latitudestatus": "",
    "longitude": "",}

Estado
titleAPP
Estado
colourYellow
titleTOTEM
Estado
colourGreen
titleBoleto
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

Expandir
titlePayload
Bloco de código
languagejson
{
    "foneid_cliente": "id_cliente",
    "telefoneid_comercialfatura": "",
    "telefone_celular": "",
    "whatsapp": "",id_fatura",
}
Expandir
titleResponse
Bloco de código
languagejson
{
    "email": "",
    "obsstatus": "",
}

Estado
colourPurple
titleProspecto
Estado
colourYellow
titleTOTEM
Status do Prospecto (GET):

Request utilizada para receber o status atual do prospecto, mantendo o sistema da Datacake sincronizado com o ERP

Expandir
titlePayload
Bloco de código
languagejson
{
    "alertaid_prospecto": "id_prospecto",
}
Expandir
titleResponse
Bloco de código
languagejson
{
    "status": "",
    "motivo": "motivo_do_cancelamento_ou_rejeição"
}