Definição de Contato Principal do Emissor
Este endpoint promove um contato existente do emissor a contato principal (is_default: true). O contato anteriormente marcado como principal passa automaticamente a is_default: false.
Trocando o contato principal do emissor
O emissor pode ter múltiplos contatos cadastrados, mas apenas um é marcado como principal. Caso o contato principal tenha sido cadastrado com um dado incorreto (typo no e-mail, dígito errado no telefone), use o fluxo abaixo para substituí-lo.
O emissor precisa estar no status in_filling. Após o emissor sair desse status, alterações em contato/conta principal não são permitidas — o endpoint retornará HTTP 400 / ISS0000011.
Fluxo de troca (3 chamadas)
- POST
.../issuer_contact_information→ cria o novo contato (correto). - POST
.../issuer_contact_information/{key}/set_default→ promove o novo contato a principal. - DELETE
.../issuer_contact_information/{old_key}→ remove o contato antigo (com o typo).
A ordem importa: como não é permitido deletar um contato marcado como principal, é obrigatório promover o novo contato antes de deletar o antigo. Tentar inverter retorna HTTP 400 / ISS0000013.
Request
Path Params
| Campo | Tipo | Descrição | Caracteres |
|---|---|---|---|
ISSUER-KEY | string | Chave única do emissor (UUID v4). | 36 |
ISSUER-CONTACT-INFORMATION-KEY | string | Chave única do contato que será promovido a principal (UUID v4). | 36 |
Request Body
Nenhum conteúdo é enviado no corpo da requisição.
Response
Contato promovido a principal. Nenhum conteúdo é retornado no corpo da resposta.
Erros
| HTTP | Código | Cenário |
|---|---|---|
| 400 | ISS0000011 | Emissor não está em in_filling. |
| 403 | ISS000011 | Tenant não tem acesso a esse emissor. |
| 404 | ISS000008 | issuer_contact_information_key não encontrado para esse emissor. |
| 404 | ISS000009 | issuer_key não encontrado. |