Assim como em Alterando um cedente e na Alteração de uma conta, a Alteração de um Convênio se resume em preenchermos um modelo de integração (JSON) com os dados do convênio a serem alterados e enviarmos para o nosso servidor.
PUT
Homologação:
http://homologacao.cobrancabancaria.tecnospeed.com.br/api/v1/cedentes/contas/convenios/:id
Produção:
https://cobrancabancaria.tecnospeed.com.br/api/v1/cedentes/contas/convenios/:id
*Deve ser informado o id do convênio que deseja alterar na URL da requisição. É o mesmo ID retornado na rotina de cadastro do convênio.
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 | Código da carteira |
| ConvenioEspecie | string | Espécie do convênio |
| ConvenioPadraoCNAB | string | Padrão CNAB. Informar 240 ou 400 |
| ConvenioNumeroRemessa | string | Número atual da remessa. Campo obrigatório para Sicredi |
| ConvenioUtilizaVan | boolean | Define se o convênio irá ou não utilizar a transmissão automática de remessa e retorno. Informar 1 para marcar essa opção como ativa. Por padrão, utiliza o valor 0. Transmissão automática disponível apenas para o ambiente de produção. |
| Conta | integer | Identificador da conta na nossa base de dados |
Exemplo:
{
"ConvenioNumero": "7889604745",
"ConvenioDescricao": "Convenio da tecnospeed",
"ConvenioCarteira": "109",
"ConvenioEspecie": "R$",
"ConvenioPadraoCNAB": "400",
"ConvenioNumeroRemessa": "1",
"Conta": 168
}
Retorno
Exemplo de retorno:
{
"_status": "sucesso",
"_dados": {
"id": 154,
"numero_convenio": "7889604745",
"descricao_convenio": "Convenio da tecnospeed",
"carteira": "109",
"especie": "Boleto",
"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
}
}
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.