Configurar Credenciales

Configurar Credenciales (Firma Digital / Token Delegado SIN)

• URL: POST /api/partner/v1/companies/credentials
• Cabeceras Obligatorias:
  • Authorization: Bearer <TOKEN_PARTNER_API>
  • tenant-key: <COMPANY_KEY_DE_LA_SUB_CUENTA>
• Content-Type: multipart/form-data (Formulario multipart debido al archivo binario)
• Descripción: Carga el certificado digital p12 y/o el Token Delegado del SIN para habilitar la facturación de la sub-compañía.

Detalles del Payload de Petición (Form-Data)

Parámetro	Tipo	Requerido	Descripción
certificate	Archivo (.p12)	Opcional*	Archivo binario del certificado digital en formato PKCS#12 (.p12). Obligatorio para Modalidad 1 (Electrónica en Línea).
certificate_password	String	Opcional*	Contraseña empleada para desencriptar la clave privada dentro del archivo .p12.
sin_token	String	Opcional*	Token de Delegación obtenido del portal SIAT del SIN. Obligatorio para Modalidad 2 (Computarizada en Línea). El sistema autodescodifica el JWT e identifica el codigoSistema y su vigencia.

Ejemplo de Respuesta de Éxito (200 OK)

{
  "status": true,
  "message": "Credenciales actualizadas correctamente."
}

Respuestas de Error

• 404 Not Found: Si la compañía (tenant-key) no existe o no te pertenece.
• 422 Unprocessable Entity: Errores de validación en el payload.
• 500 Internal Server Error: No se pudo desencriptar el certificado p12 (ej. contraseña incorrecta) o falla al guardar.