Notify Contract Signed

POST /savings-contracts/notify-contract-signed

Notifica sobre múltiples contratos de ahorro que han sido firmados en una sola operación bulk.

Endpoint

POST /savings-contracts/notify-contract-signed

Authentication

api-key: YOUR_API_KEY
Content-Type: application/json

Request Body

Campo	Tipo	Requerido	Descripción
contract_ids	array	✓	Array de IDs de contratos firmados

Ejemplo de solicitud

# Production
curl -X POST \
     -H "api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "contract_ids": [
         "contract_321",
         "contract_654",
         "contract_987"
       ]
     }' \
     "https://api.erolapp.com/api/v1/savings-contracts/notify-contract-signed"

# Staging
curl -X POST \
     -H "api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "contract_ids": [
         "contract_321",
         "contract_654",
         "contract_987"
       ]
     }' \
     "https://be-staging.erolapp.com/api/v1/savings-contracts/notify-contract-signed"

Response

Código de estado: 200 OK

{
  "success": true,
  "message": "Contract signed notifications processed successfully",
  "data": {
    "processed_contracts": 3,
    "contract_ids": [
      "contract_321",
      "contract_654",
      "contract_987"
    ],
    "processed_at": "2024-08-10T10:30:00Z",
    "status_updated_to": "active"
  },
  "meta": {
    "timestamp": "2024-08-10T10:30:00Z",
    "request_id": "req_def456"
  }
}

Casos de uso

• Activación masiva de contratos tras firma digital
• Actualización de estado de múltiples contratos desde “pending” a “active”
• Procesamiento bulk de contratos firmados en lote
• Sincronización con sistemas de firma electrónica

Notas importantes

• Este endpoint procesa las notificaciones de forma asíncrona
• Los contratos deben estar en estado “pending” para poder ser activados
• La respuesta 200 confirma que el proceso se inició correctamente
• Tras la notificación, los contratos cambian automáticamente a estado “active”
• El procesamiento real puede tardar algunos minutos

Estados de contrato

Estado Inicial	Estado Final	Descripción
pending	active	Contrato activado tras firma
draft	active	Borrador convertido en contrato activo

Error Responses

Si hay errores en el procesamiento:

{
  "success": false,
  "error": {
    "code": "INVALID_CONTRACT_STATUS",
    "message": "Some contracts are not in a valid state for signing",
    "details": {
      "invalid_status_ids": ["contract_999"],
      "current_statuses": {
        "contract_999": "cancelled"
      },
      "valid_count": 2,
      "invalid_count": 1
    }
  }
}