Sustituir los datos editables de un perfil
Actualice un perfil de registro existente perteneciente a la cuenta mediante su UUID local obtenido de create_document o documents. Esta operación modifica los datos de la cuenta y del operador proveedor. No cambia el tipo de identidad Personal/Business almacenado ni es una operación PATCH de campos parciales.
Solicitud de actualización
Autentíquese con su cuenta habilitada de la API de MultiTEL desde una dirección IP permitida. Los ejemplos utilizan credenciales en variables de entorno y datos ficticios. Lea los campos JSON status.code y status.msg, además de la respuesta HTTP.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
--header 'Content-Type: application/json' \
--data @registration-profile-update.json \
"https://api.multitel.net/v3/update_document/$DOCUMENT_UUID"{
"first_name": "Example",
"last_name": "Person",
"phone_number": "12025550123",
"email": "end-user@example.com",
"city": "Example City",
"postal_code": "00000",
"address": "1 Example Street",
"country": "US",
"nationality": "US",
"signature": "BASE64_PNG_OF_THE_AUTHORIZED_END_USER_SIGNATURE",
"id_number": "",
"personal_tax_id": "",
"birth_date": "",
"description": "Example profile",
"company_name": "",
"company_reg_number": "",
"incorporation_country": "",
"vat_id": "",
"address_description": ""
}El ejemplo muestra un perfil Personal; sustitúyalo por todos los datos que desee establecer para el usuario final y su firma autorizada. No envíe firmas de ejemplo ni valores vacíos como forma de conservar los datos. Se admiten entradas en JSON y codificadas como formulario.
| Campos | Comportamiento |
|---|---|
| first_name, last_name, city, postal_code, address | Obligatorios; cada uno admite como máximo 64 caracteres. |
| phone_number | Valor numérico obligatorio de al menos ocho caracteres; utilice dígitos en formato internacional, incluido el código de país. |
| signature | Obligatoria. El portal proporciona los bytes PNG codificados en Base64 sin el prefijo de URL de datos. |
| country | Proporcione un código ISO del país de la dirección tomado del catálogo de registro. El manejador lo resuelve, aunque la actualización de dirección revisada no modifica la relación con el país. |
| nationality | Código ISO de país obligatorio para un perfil Personal existente. |
| company_name, incorporation_country | Obligatorios para un perfil Business existente; el nombre de la empresa admite como máximo 64 caracteres y el país de constitución debe ser un código ISO. |
| Dirección de correo electrónico válida opcional de hasta 254 caracteres. Omítala para conservar el correo de contacto almacenado; envíe un valor vacío para borrarlo localmente. | |
| id_number, personal_tax_id, birth_date, description, company_reg_number, vat_id | Envíe los valores actuales que desee establecer. Los valores omitidos se consideran vacíos de forma predeterminada y pueden sobrescribir los valores ya almacenados. |
Las reglas de registro específicas de cada país pueden exigir información o formatos adicionales. No reconstruya una actualización completa únicamente a partir de get_document: su respuesta limitada omite los selectores de país, email y los identificadores de entidad. Conserve sus datos de origen autorizados o utilice el editor de documentos del portal.
Opciones avanzadas: añadir justificantes cargados previamente
Los arrays opcionales identity_encryptfiles y address_encryptfiles aceptan referencias activas pertenecientes a la cuenta procedentes de create_encrypt_files. Utilice la misma categoría de entidad que la carga y envíe la solicitud antes de que caduque la referencia. Cada archivo se adjunta en una solicitud de justificante independiente, aunque varios compartan el mismo tipo de justificante. Para un justificante de identidad con varios archivos, utilice el flujo posterior de adjuntar justificantes con un único array.
Si una prueba de dirección posterior se rechaza para una dirección recién creada, no sustituya el UUID del perfil ni vuelva a crear la identidad repetidamente. Deténgase y compruebe el perfil en el portal o con el soporte. La ruta de lectura/consulta de pruebas de dirección sigue siendo una limitación de la revisión.
Respuestas heredadas de éxito y error
{
"status": {
"code": "success",
"msg": "Successfully Saved."
},
"response": ""
}El código de éxito habitual de este endpoint es la cadena success, en lugar del valor numérico 200. Un fallo habitual del proveedor o del sistema local puede utilizar la cadena error. El código numérico 400 corresponde a campos no válidos o fallos en los justificantes, 404 a un perfil inexistente o una referencia no válida a un archivo cargado, y 500 a un cuerpo vacío o un país sin resolver. Lea el mensaje y cualquier entrada de validación; no interprete una respuesta HTTP 200 por sí sola como un éxito.
Limitaciones actuales de la actualización y recuperación
Un resultado que indique éxito no garantiza que se hayan modificado todos los campos del proveedor. El código revisado puede guardar el perfil local después de que falle una actualización de dirección en el proveedor. La actualización de identidad en el proveedor no incluye email. No se ha establecido que esta vía permita cambiar el país de la dirección ni sincronizar su descripción. Si necesita esos cambios, revise el resultado en el portal y póngase en contacto con soporte en vez de dar por hecho que se ha actualizado el registro en el proveedor.
La actualización no constituye una única transacción atómica: los cambios de identidad y los adjuntos de justificantes pueden realizarse antes de un fallo posterior. No se ofrece ninguna clave de idempotencia. Tras una respuesta incierta, revise el perfil y los adjuntos antes de volver a intentarlo; el envío repetido de justificantes puede crear duplicados. Actualizar un perfil no implica la aprobación de los justificantes ni activa un número.