Notification business complete from external (delete all information)
POST
/api/v4/fiduciary/{business_id}/complete
Notificación de negocio completado desde proveedor
delete_mode, el endpoint elimina determinados participantes del negocio y, si corresponde, elimina también el negocio completo.⚠️ IMPORTANTE: El negocio debe encontrarse en estado Completado y con Aprobado = verdadero. En caso contrario, no se eliminará información y la solicitud devolverá un error.
Ejemplo de Solicitud
Params
| Nombre | Tipo | Descripción |
|---|---|---|
business_id | Integer | ID del negocio que fue completado desde el proveedor. |
Body
{
"delete_mode": "vacío | all | juridical_only"
}delete_mode define qué participantes serán eliminados. Valores permitidos: "" (por defecto), "all" o "juridical_only". Cualquier otro valor devolverá invalid_request (400).Comportamiento de delete_mode
| Valor | Comportamiento |
|---|---|
"" (por defecto) | Elimina únicamente los participantes que no tienen un folio de acto jurídico. |
"juridical_only" | Elimina únicamente los participantes que sí tienen un folio de acto jurídico. |
"all" | Elimina todos los participantes del negocio. |
Ejemplo de Respuesta
{
"data": {},
"success": true,
"message": "Provider completion acknowledged. Participants without juridical folio permanently deleted"
}Mensajes de respuesta
message varía dependiendo del valor enviado en delete_mode.delete_mode | Mensaje |
|---|---|
"" (por defecto) | Provider completion acknowledged. Participants without juridical folio permanently deleted |
"juridical_only" | Provider completion acknowledged. Participants with juridical folio permanently deleted |
"all" | Provider completion acknowledged. All participants and business data permanently deleted |
delete_mode es opcional. Si no se envía, se utilizará el valor por defecto ("").delete_mode son eliminados de forma permanente.delete_mode sea "all", ox-api-key, service y Authorization con un Bearer Token válido para evitar errores de autenticación.code_message, el cual puede variar dependiendo del tipo de error (por ejemplo: invalid_request, unauthorized o server_error).Solicitud
Parámetros de ruta
Parámetros de Header
Respuestas
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v4/fiduciary/0/complete' \
--header 'x-api-key: {{api-key}}' \
--header 'service: {{service}}'Respuesta Ejemplo de Respuesta
200 - Success deleting
{
"data": {},
"message": "Provider completion acknowledged. Participants without juridical folio permanently deleted",
"success": true
}Modificado en 2026-07-10 19:37:20