Assim como a conta, o cadastro do convênio irá fornecer informações para outros fluxos da aplicação. É nele que vamos configurar dados como carteira, CNAB, forma de registro, etc. Lembre-se que vamos precisar do campo id da conta que foi retornado na requisição anterior. Isso acontece pois um cedente pode ter várias contas, e é através desse ID que vinculamos esse novo convênio à conta correta.
POST
Homologação:
https://homologacao.plugboleto.com.br/api/v1/cedentes/contas/convenios
Produção:
https://plugboleto.com.br/api/v1/cedentes/contas/convenios
Headers
Nome | Descrição | Exemplo |
Content-Type | Indica o tipo de arquivo | application/json |
cnpj-sh | CNPJ ou CPF da Software House | 01001001000113 |
token-sh | Token da Software House | f22b97c0c9a3d41ac0a3875aba69e5aa |
cnpj-cedente | CNPJ ou CPF do cedente | 01001001000113 |
Body
Campo | Tipo | Descrição |
ConvenioNumero | string | Número do convênio |
ConvenioDescricao | string | Descrição do convênio |
ConvenioCarteira | string | Número da carteira |
ConvenioCarteiraCodigo | string |
Campo opcional. Valores aceitos: 1 = Cobrança Simples |
ConvenioEspecie | string | Espécie do convênio |
ConvenioPadraoCNAB | string | Padrão CNAB. Informar 240 ou 400 |
ConvenioReiniciarDiariamente | boolean | Define se o número atual da remessa será reiniciado diariamente. |
ConvenioNumeroRemessa | string | Número atual da remessa. Campo obrigatório para Sicredi |
Conta | integer | Identificador da conta na nossa base de dados. O campo "id" será disponibilizado a você no json de retorno da rota de cadastro da conta. |
ConvenioDensidaDeRemessa | integer | Código de Densidade da remessa (verificar a necessidade de preenchimento na seção "Dicas de preenchimento"). Preencher com 1600 ou 6250, conforme orientação do banco. |
ConvenioRegistroInstantaneo | boolean | Define se o convênio irá ou não utilizar a transmissão instantânea. |
ConvenioApiId | string | Campo utilizado para a transmissão instantânea, dúvida de como preencher clique aqui |
ConvenioApiKey | string | Campo utilizado para a transmissão instantânea, dúvida de como preencher clique aqui |
ConvenioApiSecret | string | Campo utilizado para a transmissão instantânea, dúvida de como preencher clique aqui |
ConvenioEstacao | string | Campo utilizado para a transmissão instantânea, dúvida de como preencher clique aqui |
ConvenioNossoNumeroBanco | Boolean | Define se o Nosso Numero será controlado pelo banco. (Carteira Escritural) |
Conveniotipowebservice | string |
Campo utilizado para registro instantâneo do banco do brasil, para que seja possível escolher a versão da API a ser utilizada pelo banco. Valores aceitos v1 ou v2.
Caso o convênio seja do Itaú, as opções aceitas são: NORMAL ou SHOP FACIL. O tipo do WS é definido pelo banco, no momento da liberação do serviço. |
ConvenioNumeroContrato | string |
Campo utilizado para informar o "número de contrato" da conta caso o banco Banrisul exija este campo presente na remessa.
Disponível apenas no CNAB 240. |
ConvenioVersaoLayoutArquivo
|
string |
Versão do layout que deseja utilizar do banco (opcional)
|
Dica: Para auxiliar no cadastro do convênio, possuímos uma seção de dicas, onde você encontra um detalhamento sobre as informações que devem ser preenchidas para cada banco.
Segue o link desta documentação: https://atendimento.tecnospeed.com.br/hc/pt-br/sections/360002897054-Dicas-para-cadastro-de-contas-e-conv%C3%AAnios
Exemplo:
{
"ConvenioNumero": "7889604745",
"ConvenioDescricao": "Convenio da tecnospeed",
"ConvenioCarteira": "109",
"ConvenioEspecie": "R$",
"ConvenioPadraoCNAB": "400",
"ConvenioNumeroRemessa": "1",
"ConvenioReiniciarDiariamente": false,
"Conta": 168
}
Retorno
Exemplo de retorno:
{
"_status": "sucesso",
"_dados": {
"id": 154,
"numero_convenio": "7889604745",
"descricao_convenio": "Convenio da tecnospeed",
"carteira": "109",
"especie": "R$",
"id_conta": 168,
"criado": "2017-03-30T18:01:19.000Z",
"atualizado": "2017-03-30T18:01:19.000Z",
"padraoCNAB": "400",
"utiliza_van": false,
"numero_remessa": 1
}
}
Obs.: É importantíssimo persistir em seu banco de dados o ID do Convênio retornado na resposta da requisição. Ele será usado caso seja preciso fazer alterações no cadastro do convênio futuramente.
Exemplo de retorno com erro:
{
"_status": "erro",
"_mensagem": "Acesso negado.",
"_dados": [
{
"_erro": "Conta do Cedente não encontrada"
}
]
}
Comentários
0 comentário
Por favor, entre para comentar.