Carga, consulta y elimina los CSD de tu cuenta. Los mismos certificados que administras en el Administrador de Timbres, desde tu código.
Ver librerías✓Antes de empezar
- 1Obtén un Bearer Token con tu usuario y contraseña de SW. Se recomienda usar un token infinito. Las cinco operaciones lo piden en el header
Authorization. - 2Ten a la mano el
.cery el.keydel emisor en Base64, y la contraseña de la llave. En pruebas usa los CSD de pruebas vigentes. - 3Carga el CSD una vez por emisor. Después ya puedes timbrar: el servicio de Emisión-Timbrado toma los CSD que hayas cargado.
💡 Nota Importante: Para administrar los certificados de manera gráfica, puedes hacerlo desde el Administrador de Timbres.
URL´s
Marca tu ambiente activo. Los botones de copiar y los ejemplos de código de abajo se arman con la base que elijas aquí.
🛠️ Pruebas:
https://services.test.sw.com.mx
🚀 Productivo:
https://services.sw.com.mx
🔗 Endpoint
Tres acciones sobre el mismo recurso. Elige una y abajo se arma su referencia completa: endpoint, headers, parámetros, ejemplo y respuesta.
Carga el CSD de un emisor en tu cuenta. Este servicio recibe el .cer y el .key en Base64, más la contraseña de la llave. Es el paso previo a timbrar con ese RFC.
POST/certificates/save
Propiedad
Uso
Descripción
Authorization
REQUERIDO
Bearer {token} — token obtenido del servicio de autenticación.
Content-Type
REQUERIDO
application/json — el cuerpo va como JSON.
Propiedad
Uso
Descripción
type
REQUERIDO
Tipo de certificado. Coloca el valor “stamp”.
b64Cer
REQUERIDO
Contenido del archivo .cer en Base64.
b64Key
REQUERIDO
Contenido del archivo .key en Base64.
password
REQUERIDO
Contraseña de la llave privada.
💡 Nota: Si no hay certificados cargados, la consulta responde
success con un arreglo data vacío.GET/certificates
Propiedad
Uso
Descripción
Authorization
REQUERIDO
Bearer {token} — token obtenido del servicio de autenticación.
Devuelve un solo certificado a partir de su número de serie. Útil para verificar la vigencia antes de timbrar.
GET/certificates/{noCertificado}
Propiedad
Uso
Descripción
Authorization
REQUERIDO
Bearer {token} — token obtenido del servicio de autenticación.
Propiedad
Uso
Descripción
noCertificado
REQUERIDO
Número de serie del certificado a obtener, de 20 dígitos.
Devuelve todos los certificados cargados de un mismo contribuyente.
GET/certificates/rfc/{rfc}
Propiedad
Uso
Descripción
Authorization
REQUERIDO
Bearer {token} — token obtenido del servicio de autenticación.
Propiedad
Uso
Descripción
rfc
REQUERIDO
RFC del contribuyente a consultar, con homoclave.
Servicio para eliminar un certificado de la cuenta enviando como parámetro el número de certificado.
DELETE/certificates/{noCertificado}
Propiedad
Uso
Descripción
Authorization
REQUERIDO
Bearer {token} — token obtenido del servicio de autenticación.
Propiedad
Uso
Descripción
noCertificado
REQUERIDO
Número de serie del certificado a eliminar.
Ejemplo Request
💡 Nota: Estos ejemplos están basados en los SDK de SW, pero puedes armar la petición directamente contra la API REST en el lenguaje que prefieras.
Respuesta
Propiedad
Tipo
Descripción
data
string
Mensaje de confirmación: “CSD Guardados Correctamente.”
status
string
Siempre “success” en una respuesta 200.
Causa: Falta alguno de los tres archivos (b64Cer, b64Key, password) o llegaron vacíos. También ocurre cuando el Base64 se cortó al construir el JSON.
Solución: Envía las cuatro propiedades con valor. Genera el Base64 del .cer y del .key completos —sin saltos de línea— y confirma que la contraseña sea la de la llave, no la de la e.firma.
Propiedad
Tipo
Descripción
message
string
Mensaje o código regresado cuando existe un error.
messageDetail
string | null
Mensaje más descriptivo del error cuando existe uno.
data
null
Siempre null: el certificado no se guardó.
status
string
Siempre “error” en una respuesta de fallo.
Causa:Alguno de los archivos (.cer o .key) vienen incompletos, o con espacios en blanco.
Solución: Envía las cuatro propiedades en Base64 del .cer y del .key completos sin saltos de línea, espacios en blanco o incompletos.
Propiedad
Tipo
Descripción
message
string
Mensaje o código regresado cuando existe un error.
messageDetail
string | null
Mensaje más descriptivo del error cuando existe uno.
data
null
Siempre null: el certificado no se guardó.
status
string
Siempre “error” en una respuesta de fallo.
Propiedad
Tipo
Descripción
data[].issuer_rfc
string
RFC del emisor dueño del certificado.
data[].certificate_number
string
Número de serie del CSD, de 20 dígitos.
data[].csd_certificate
string
Certificado en Base64.
data[].is_active
boolean
false cuando el certificado fue desactivado o ya venció.
data[].issuer_business_name
string
Razón social del emisor.
data[].valid_from
string
Inicio de vigencia del CSD.
data[].valid_to
string
Fin de vigencia del CSD.
data[].certificate_type
string
Tipo de certificado: “stamp” para sellado.
status
string
Siempre “success” en una respuesta 200.
Causa: El Bearer Token se envió incompleto, cortado o sin el prefijo “Bearer “.
Solución: Envía el token completo en el header Authorization. Cachéalo y renuévalo antes de que expire en lugar de pedir uno nuevo en cada consulta.
Propiedad
Tipo
Descripción
message
string
Mensaje o código regresado cuando existe un error.
messageDetail
string | null
Mensaje más descriptivo del error cuando existe uno.
data
null
Siempre null: la consulta no se ejecutó.
status
string
Siempre “error” en una respuesta de fallo.
Propiedad
Tipo
Descripción
data.issuer_rfc
string
RFC del emisor dueño del certificado.
data.certificate_number
string
Número de serie del CSD, de 20 dígitos.
data.csd_certificate
string
Certificado en Base64.
data.is_active
boolean
false cuando el certificado fue desactivado o ya venció.
data.issuer_business_name
string
Razón social del emisor.
data.valid_from
string
Inicio de vigencia del CSD.
data.valid_to
string
Fin de vigencia del CSD.
data.certificate_type
string
Tipo de certificado: “stamp” para sellado.
status
string
Siempre “success” en una respuesta 200.
Causa: El número de serie no existe en la cuenta, está mal escrito —le falta un dígito— o el certificado ya fue desactivado.
Solución: Copia el certificate_number tal cual lo devuelve “Consultar todos”: son 20 dígitos. Si el certificado está desactivado, vuelve a cargarlo con la operación Cargar.
Propiedad
Tipo
Descripción
message
string
Mensaje o código regresado cuando existe un error.
messageDetail
string | null
Mensaje más descriptivo del error cuando existe uno.
data
Array/null
Arreglo de objetos con información de los certificados CSD del emisor, como RFC, vigencia, número de serie y estado.
status
string
Siempre “error” en una respuesta de fallo.
Propiedad
Tipo
Descripción
data[].issuer_rfc
string
RFC del emisor dueño del certificado.
data[].certificate_number
string
Número de serie del CSD, de 20 dígitos.
data[].csd_certificate
string
Certificado en Base64.
data[].is_active
boolean
false cuando el certificado fue desactivado o ya venció.
data[].issuer_business_name
string
Razón social del emisor.
data[].valid_from
string
Inicio de vigencia del CSD.
data[].valid_to
string
Fin de vigencia del CSD.
data[].certificate_type
string
Tipo de certificado: “stamp” para sellado.
status
string
Siempre “success” en una respuesta 200.
Causa: El RFC no tiene un formato válido: le falta la homoclave, trae espacios o guiones.
Solución: Envía el RFC en mayúsculas, sin espacios ni guiones y con homoclave. Si el formato es correcto y aun así falla, confirma que ese RFC tenga certificados cargados en la cuenta.
Propiedad
Tipo
Descripción
message
string
Mensaje o código regresado cuando existe un error.
messageDetail
string
Mensaje más descriptivo del error cuando existe uno.
data
Array/null
Arreglo de objetos con información de los certificados CSD del emisor, como RFC, vigencia, número de serie y estado.
status
string
Siempre “error” en una respuesta de fallo.
Propiedad
Tipo
Descripción
data
string
Mensaje de confirmación con el número del certificado desactivado.
status
string
Siempre “success” en una respuesta 200.
Causa: El número de serie no corresponde a un certificado activo de la cuenta, o ya se había eliminado.
Solución: Verifica el certificate_number con “Consultar todos” antes de eliminar. Si el error persiste con un número válido, escribe a soporte@sw.com.mx con el número de serie.
Propiedad
Tipo
Descripción
message
string
Mensaje o código regresado cuando existe un error.
messageDetail
string | null
Mensaje más descriptivo del error cuando existe uno.
data
String/null
Mensaje de confirmación que los CSD se han eliminado de forma exitosa.
status
string
Siempre “error” en una respuesta de fallo.