Integrações

Processo de integração do sistema

Banco do Brasil

Pix

Recebimentos de pix

Fluxo

• Pix é pago pelo usuário
• BB envia webhook
• AWS - API gateway recebe o webhook (bbwh.doth.link)
• SQS (filaBBPix)
• Lambda (bb_MySql)

endToEndId

GG.FFF.YYZZZ.TT.IIIIIIIIIII.RRRRRRRRRRR

• GG - grupo econômico
• FFFF - 101 - unidade
• YYZZZZ - 23065 - (ano/dia)
• TT - 03 - tipo
• IIIIIIIIIII - 00000000001 - id do pix
• RRRRRRRRRRR - 00000000023 - id da referencia do pix

Tipos de Pix

• 01 – caixa mensalidade única
• 02 – caixa mensalidades múltiplas
• 03 – caixa ordem de serviço
• 04 – caixa parcela única (fazer)
• 05 – caixa contrato (fazer)
• 06 – avulsos – ok
• 07 – pré vendas – ok
• 08 – clinica
• 09 – exames

ClickSign

Processo de integração para assinatura de documentos

1. Criar conta na clicksign
2. Plano de intração
3. Gerar novo Token
4. Cadastrar webhook

Webhook

Retorno de eventos pré definidos

WhatsApp

Url base: https:/doth/apis/clicksign/whatsapp.php

termos:

acceptance_term_completed acceptance_term_refused acceptance_term_canceled acceptance_term_expired acceptance_term_error attempts_by_whatsapp_exceeded acceptance_term_sent

Enotas

Processo de integração utilizado para emissão de nota fiscal (serviços e produtos)

• A empresa deve possuir certificado digital
• Para cadastro de emissão de NFC-e deve possuir o códico CSC (cadastrado no Sefaz)

WebHook

Recebido após a emissão da nota fiscal (serviço ou produto)

Headers

• x-token - chave de validação (fixa)

tipo - NFS-e / NFC-e

nfeIdExterno

H.GG.FFF.T.IIIIIIIIIII.X.RRRRRRRRRRR

• H - Servidor (Homologação/Produção)
• GG - Grupo econôminco (000)
• FFF - Unidade (000)
• T - Tipo de nota: Plano, Os, Serviço, Venda, E cafe)
• IIIIIIIIIII - Id do tipo (00000000000)
• X - Separador (X)
• RRRRRRRRRRR - Id de referência (00000000000)

Tipos

• P - Plano
• O - Ordem de serviço
• S - Serviços
• V - Vendas
• C - Café

Tabelas

• P - Plano - insert tabela enotas_plns
• O - Ordem de serviço - insert tabela enotas_os
• S - Serviços - update tabela ordemservico_nfs
• V - Vendas - update tabela ordemservico_nfs
• C - Café - sem definição

NFS-e

{

   "tipo": "NFS-e",
   "empresaId": "string",
   "nfeId": "string",
   "nfeIdExterno": "string",
   "nfeStatus": "string",
   "nfeMotivoStatus": "string",
   "nfeLinkPdf": "http://api.enotasgw.com.br/file/(...)/pdf",
   "nfeLinkXml": "http://api.enotasgw.com.br/file/(...)/xml",
   "nfeNumero": "string",
   "nfeCodigoVerificacao": "string",
   "nfeNumeroRps": "string",
   "nfeSerieRps": "string",
   "nfeDataCompetencia": "date"

}

NFC-e

{

   "tipo": "NFC-e",
   "empresaId": "string",
   "nfeId": "001",
   "nfeStatus": "Autorizada",
   "nfeMotivoStatus": null,
   "nfeLinkDanfe": "http://api.enotasgw.com.br/file/(...)/pdf",
   "nfeLinkXml": "http://api.enotasgw.com.br/file/(...)/pdf",
   "nfeLinkConsultaPorChaveAcesso": "http://sistemas.sefaz.am.gov.br/nfceweb/formConsulta.do",
   "nfeNumero": "123",
   "nfeSerie": "1",
   "nfeChaveAcesso": "73349650010000005351606919674115087649800517",
   "nfeDataEmissao": "2017-01-02T17:20:32Z",
   "nfeDataAutorizacao": "2017-01-02T17:21:07Z",
   "nfeNumeroProtocolo": "353150000119390",
   "nfeDigestValue": "ssiUjiiOQkD2UGw"

}

Vindi

Empresa especializada na cobrança de valores recorrentes via cartão de crédito

O Doth possui integração com o software Vindi. Isso significa que quando a fatura for paga na vindi, será enviado a informação de baixa para o sistema

Configuração

1. No código externo do cliente deve estar informado o número da inscrição
2. Criar webhook com status de fatura paga para o endereço: https://erp.doth.com.br/apis/vindi/hook.php?secret=x

Funcionamento

1. A cada fatura paga será enviada a informação da baixa diretamente para o sistema
2. É realizada uma pré-baixa que fica disponível em: Processos > Externos > Importar Vindi/pago. 5.07.04. - Imporar vindi/pago
3. É possível consultar as faturas em Aberto (ainda não processadas) ou Baixadas (já processadas)
4. Processar as baixas

Obs: é considerado como mês de pagamento o mês onde a fatura foi efetivamente lançada no cartão do cliente.

WhatsApp

Integração utilizada para envio de mensagens pelo sistema via whatsapp

A integração não serve para envio em massa

• Cadastrar instância no servidor
• Conectar whatsapp