Integrações

Processo de integração do sistema

Banco do Brasil

Pix

Recebimentos de pix

{"pix":[{"endToEndId":"E18236120202310241126s0094c62752","txid":"1110323296010000001895700011417535","valor":"4.60","componentesValor":{"original":{"valor":"4.60"}},"chave":"485e87ab-9f2c-4f18-83c9-10dbbaf35173","horario":"2023-10-24T08:26:39.00-03:00","infoPagador":"Servico Funerario de Botucatu","pagador":{"cpf":"00000000000","nome":"NOME DO PAGADOR"}}]}

Fluxo

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

txid

GG.FFF.YYZZZ.TT.IIIIIIIIIII.RRRRRRRRRRR

• GG - grupo econômico
• FFF - 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
   1. No webhook copiar a chave Hash

Webhook

Retorno de eventos pré definidos

WhatsApp

Url base: https:/doth/apis/clicksign/whatsapp.php?g=xx

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)

Documentação: https://docs.enotasgw.com.br/docs/webhook

Headers

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

Status

nfeStatus": "Negada",

nfeStatus": "CancelamentoNegado"

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
• E - 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

Updates

P -

O -

S - UPDATE ordemservico_nfs SET status_osnfs = ?, rps_osnfs=nfeNumeroRps, numero_osnfs=nfeNumero, erie_osnfs=nfeSerieRps, chave_osnfs=nfeCodigoVerificacao WHERE id_osnfs = RRRRRRRRRRR AND os_osnfs = IIIIIIIIIII

E - UPDATE cafe_vendas SET cfnum_cfvd=nfeNumero, cfserie_cfvd=nfeSerie, cfchave_cfvd=nfeChaveAcesso, cfdnfe_cfvd=nfeLinkDanfe WHERE id_cfvd = IIIIIIIIIII AND gprf_cfvd = GG

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"

}

MTLS

Bucket S3

versionamento: ativado colocar o arquivo

TrustStore

• Nome: truststore.pem
• Arquvivo a ser disponiblizado no S3
• Precisa estar versionado

Conteúdo

Chave enviada pelo fornecedor (banco), unificada em um único arquivo

• chave 1 - chave raiz (autoridade certificadora)
• chave 2 - chave intermediaria (serasa)
• chave 3 - chave privada (api.webhook...)

PagSeguro

Processo de integração junto a PagSeguro

Checkouts (links de pagamento)

Processo para gerar links de pagamento através do sistema

a) necesário ter um token pagseguro

1. Acesse a sua conta PagBank;
2. No menu lateral, selecione Venda online;
3. Selecione a opção Integrações;
4. Clique em Gerar Token.

Terminais POS

1. Estabelecimento credenciado junto a PagSeguro
2. Habilitar o terminal para o aplicativo junto a PagSeguro
3. Solicitar exclusão do PagVendas
4. Cadastrar o serial do terminal no Doth

Rd Station

Configuração

Tutorial: https://developers.rdstation.com/reference/autentica%C3%A7%C3%A3o

01 - Criar aplicativo

• acessar o publisher https://appstore.rdstation.com/pt-BR/publisher
• criar um app privado
• url callback: https://testes.doth.com.br/apis/rdstation
• copiar client id e client secret

02 - Executar passo 2 no navegador

• url: https://api.rd.services/auth/dialog?client_id=client_id&redirect_uri=redirect_uri
• obter o code

03 - obter bearer

• pegar codigo beare
• pegar refresh token

04 - refresh token

• colocar no codigo do lambda

Pré venda

Opção utilizada dentro da própria tela de pré vendas

Tags: planosweb,vendas, filial, cidade (substituem as tags anteriores)

Objetivos: disparo

Planos Ativos

Opção de envio: 5.07.08.02

Tags: planos, associados, filial, cidade (substituem as tags anteriores)

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 Vindi

1. cadastro de produto
   1. cadastro de produtona Vindi de valor 0,00 (preço fixo)
   2. colocar o codigo do produto na tabela de filiais

1. cadastro de plano
   1. cadastro de plano de assinautura na vindi sem nenhum produto

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