Webservice (Comercial Contratos - Alterar forma de cobrança para fatura digital): mudanças entre as edições
Ir para navegação
Ir para pesquisar
(Criou página com ' Voltar ao menu Webservice Comercial Contratos') |
Sem resumo de edição |
||
Linha 1: | Linha 1: | ||
'''Descrição:''' Alterar a forma de cobrança do cliente. | |||
'''URL:''' https://[URL]/ws/comercial/cliente/{idCliente}/alterar/fatura_digital | |||
'''Método:''' POST | |||
'''Entrada:''' Pelo PathParam passar o código do cliente, JSON contendo usuário e senha. | |||
'''Saída:''' "OK" se for alterado algum contrato do cliente para a nova forma de cobrança, nesse caso o cliente receberá um email informando que a alteração para fatura digital foi feita com sucesso. Caso não aconteça alteração em nenhum contrato (por não ter nenhum habilitado que não seja débito e nem isento ou por não ter forma de cobrança do tipo fatura digital ativa) a resposta será "NOT_MODIFIED". | |||
'''Campos JSON de entrada:''' | |||
{| class="wikitable" | |||
|'''Tag''' | |||
|'''Tipo Parâmetro''' | |||
|'''Tipo''' | |||
|'''Obrigatório''' | |||
|'''Observação''' | |||
|- | |||
|idCliente | |||
|Path Param | |||
|String | |||
|SIM | |||
| | |||
|- | |||
|usuario | |||
|body | |||
|String | |||
|SIM | |||
| | |||
|- | |||
|senha | |||
|body | |||
|String | |||
|SIM | |||
| | |||
|} | |||
'''Exemplo:''' | |||
* '''Envio:''' | |||
** https://[URL]/ws/comercial/cliente/{idCliente}/alterar/fatura_digital | |||
*** '''Parâmetros adicionais:'''<syntaxhighlight lang="json" line="1"> | |||
{ | |||
"usuario":"12312312312", | |||
"senha":"12312312312" | |||
} | |||
</syntaxhighlight> | |||
* '''Retorno:''' | |||
** '''Sucesso:'''<syntaxhighlight lang="json" line="1"> | |||
{ | |||
"Status":"OK", | |||
"Contratos":[ | |||
355568, | |||
355589 | |||
], | |||
"Mensagem":"Foi alterado para Fatura Digital!" | |||
} | |||
</syntaxhighlight> | |||
** '''Erro:''' | |||
*** Não foi possível alterar a forma de cobrança.<syntaxhighlight lang="json"> | |||
{ | |||
"Status":"NOT_MODIFIED", | |||
"Mensagem":"Não foi possivel alterar para Fatura Digital!" | |||
} | |||
</syntaxhighlight> | |||
*** Erro interno.<syntaxhighlight lang="json" line="1"> | |||
{ | |||
"Status":"INTERNAL_SERVER_ERROR", | |||
"Erro":"Mensagem informado o tipo do Erro", | |||
"Mensagem":"Não foi possível alterar para Fatura Digital!" | |||
} | |||
</syntaxhighlight> | |||
[[Webservice (Comercial Contratos)|Voltar ao menu Webservice Comercial Contratos]] | [[Webservice (Comercial Contratos)|Voltar ao menu Webservice Comercial Contratos]] |
Edição atual tal como às 15h01min de 19 de maio de 2023
Descrição: Alterar a forma de cobrança do cliente.
URL: https://[URL]/ws/comercial/cliente/{idCliente}/alterar/fatura_digital
Método: POST
Entrada: Pelo PathParam passar o código do cliente, JSON contendo usuário e senha.
Saída: "OK" se for alterado algum contrato do cliente para a nova forma de cobrança, nesse caso o cliente receberá um email informando que a alteração para fatura digital foi feita com sucesso. Caso não aconteça alteração em nenhum contrato (por não ter nenhum habilitado que não seja débito e nem isento ou por não ter forma de cobrança do tipo fatura digital ativa) a resposta será "NOT_MODIFIED".
Campos JSON de entrada:
Tag | Tipo Parâmetro | Tipo | Obrigatório | Observação |
idCliente | Path Param | String | SIM | |
usuario | body | String | SIM | |
senha | body | String | SIM |
Exemplo:
- Envio:
- https://[URL]/ws/comercial/cliente/{idCliente}/alterar/fatura_digital
- Parâmetros adicionais:
{ "usuario":"12312312312", "senha":"12312312312" }
- Parâmetros adicionais:
- https://[URL]/ws/comercial/cliente/{idCliente}/alterar/fatura_digital
- Retorno:
- Sucesso:
{ "Status":"OK", "Contratos":[ 355568, 355589 ], "Mensagem":"Foi alterado para Fatura Digital!" }
- Erro:
- Não foi possível alterar a forma de cobrança.
{ "Status":"NOT_MODIFIED", "Mensagem":"Não foi possivel alterar para Fatura Digital!" }
- Erro interno.
{ "Status":"INTERNAL_SERVER_ERROR", "Erro":"Mensagem informado o tipo do Erro", "Mensagem":"Não foi possível alterar para Fatura Digital!" }
- Não foi possível alterar a forma de cobrança.
- Sucesso: