API mediante la cual se firma el manifiesto de un Emisor
Mediante esta API, se puede firmar el manifiesto enviando los archivos requeridos correspondientes a la FIEL junto con la contraseña y el correo electrónico relacionado con el emisor, de igual manera al finalizar la petición les llegará un correo con el Manifiesto adjunto.
URL´s
https://api.test.sw.com.mx 📄
https://api.sw.com.mx 📄
Firma de Manifiesto y Envío de Manifiesto
Método en un solo paso para firmar el manifiesto, enviando certificado y llave privada correspondientes a la FIEL, junto con su contraseña, como respuesta se obtendrá el PDF del Manifiesto Firmado
🔗 Endpoint
| Método | Descripción |
|---|---|
| POST | /management/v2/api/dealers/manifests |
🔐 Autenticación y Headers
| Header | Value |
|---|---|
| Authorization | Bearer Token |
| Content-Type | application/json |
🧾 Parámetros JSON
| Propiedad | Uso | Descripción |
|---|---|---|
| B64Cer | Requerido | Certificado en base 64. |
| B64Key | Requerido | Llave privada en base 64. |
| Password | Requerido | Contraseña de los certificados para firmar el Manifiesto. |
| SendEmail | Requerido | Se especifica si se enviara el documento del Manifiesto por correo. |
| Requerido | Correo electrónico a donde llegara el Manifiesto ya firmado. |
Ejemplo Request
curl --location 'https://api.test.sw.com.mx/management/v2/api/dealers/manifests' \
--header 'Authorization: Bearer token' \
--header 'Content-Type: application/json' \
--data-raw '{
"B64Cer":"MIIF0...",
"B64Key":"MIIFD...",
"Password":"12345678a",
"SendEmail":true,
"Email":"correo@gmail.com"
}'
Ejemplo Response
La respuesta exitosa sera el archivo pdf del Manifiesto firmado.
{
"message": "El certificado publico no es base64",
"status": "error"
}
| Atributo | Tipo | Descripción |
|---|---|---|
| message | String | mensaje regresado cuando existe un error. |
| status | String | “error” |
Firma Manifiesto en dos pasos.
1.-Obtener Leyenda de Firma Manifiesto
Método para obtener la leyenda del manifiesto únicamente enviando el certificado público, correspondiente a la FIEL para obtenerlo con los datos de dicho certificado. Posteriormente, deberás enviar Sellado el texto de Firma Manifiesto.
🔗 Endpoint
| Método | Ruta |
|---|---|
| PATCH | /management/v2/api/dealers/manifests |
🔐 Autenticación y Headers
| Header | Value |
|---|---|
| Authorization | Bearer Token |
| Content-Type | application/json |
🧾 Parámetros JSON
| Propiedad | Uso | Descripción |
|---|---|---|
| B64Cer | Requerido | Certificado en base 64. |
Ejemplo Request
curl --location 'https://api.test.sw.com.mx/management/v2/api/dealers/manifests' \
--header 'Authorization: Bearer token' \
--header 'Content-Type: application/json' \
--data-raw '{
"B64Cer":"MIIF0...",
}'
Ejemplo Response
{
"data": {
"rfc": null,
"company_name": null,
"contentB64": "UG9yIG1lZGlvIGRlbCBwcmVzZW50ZSwgWE9DSElMVCBDQVNBUyBDSEFWRVosIGNvbiBSRkMgQ0FDWDc2MDUxMDFQOCwgbWFuaWZpZXN0byBtaSBjb25mb3JtaWRhZCB5IGF1dG9yaXphY2nDs24gcGFyYSBxdWUgbGEgZW1wcmVzYSBMVU5BIFNPRlQsUy5BLiBERSBDLlYuLCBQcm92ZWVkb3IgQXV0b3JpemFkbyBkZSBDZXJ0aWZpY2FjacOzbiBkZSBDRkRJIGNvbiBuw7ptZXJvIGRlIGF1dG9yaXphY2nDs24gMTY1NDMsIHByb2NlZGEgYSBlbnRyZWdhciBhbCBTZXJ2aWNpbyBkZSBBZG1pbmlzdHJhY2nDs24gVHJpYnV0YXJpYSwgY29waWEgZGUgbG9zIGNvbXByb2JhbnRlcyBmaXNjYWxlcyBxdWUgbWUgaGF5YSBjZXJ0aWZpY2FkbywgZGUgYWN1ZXJkbyBhIGxvIGVzdGFibGVjaWRvIGVuIGxhIHJlZ2xhIDIuNy4yLjcgZGUgbGEgUmVzb2x1Y2nDs24gTWlzY2Vsw6FuZWEgRmlzY2FsIHBhcmEgMjAxOSBwdWJsaWNhZGEgZW4gZWwgRGlhcmlvIE9maWNpYWwgZGUgbGEgRmVkZXJhY2nDs24gZWwgMjkgZGUgQWJyaWwgZGUgMjAxOS4gQWwgbWlzbW8gdGllbXBvIGFjZXB0byBxdWUgZW1wcmVzYSBMVU5BIFNPRlQsIFMuQS4gREUgQy5WLiwgc2VhIHF1aWVuIG1lIHByb3BvcmNpb25lIGEgbWkgbm9tYnJlIG8gYWwgZGUgbWkgcmVwcmVzZW50YWRhLCBlbCAqU2VydmljaW8gZGUgQ2VydGlmaWNhY2nDs24gcGFyYSB0b2RvcyBsb3MgQ29tcHJvYmFudGVzIEZpc2NhbGVzIERpZ2l0YWxlcyBwb3IgSW50ZXJuZXQgKENGREkpIHF1ZSBlbWl0YSBjb21vIHBlcnNvbmEgZsOtc2ljYSBvIGNvbW8gcGVyc29uYSBtb3JhbC4gKlNlcnZpY2lvIGRlIENlcnRpZmljYWNpw7NuOiBzZSByZWZpZXJlIGEgdmFsaWRhY2nDs24geSB0aW1icmFkbyBkZSBDb21wcm9iYW50ZXMgRmlzY2FsZXMgRGlnaXRhbGVzIHBvciBJbnRlcm5ldCAoQ0ZESSku",
"contentBytesSize": 921
},
"meta": null,
"links": null,
"status": "success"
}
{
"message": "El certificado publico no es base64",
"status": "error"
}
| Atributo | Tipo | Descripción |
|---|---|---|
| message | String | mensaje regresado cuando existe un error. |
| data | Object/null | Objeto de datos con la leyenda del manifiesto en base 64 cuando ha sido exitoso. |
| status | String | “success” o “error” |
2.-Firma de Manifiesto mediante el Sello
Método en dos pasos para firmar el manifiesto, el sello del texto del manifiesto y el texto del manifiesto, como respuesta se obtendrá el PDF del Manifiesto Firmado. (Deberás obtener la leyenda de Firma Manifiesto)
🔗 Endpoint
| Método | Ruta |
|---|---|
| PUT | /management/v2/api/dealers/manifests |
🔐 Autenticación y Headers
| Header | Value |
|---|---|
| Authorization | Bearer Token |
| Content-Type | application/json |
🧾 Parámetros JSON
| Propiedad | Uso | Descripción |
|---|---|---|
| B64Cer | Requerido | Certificado en base 64. |
| B64ManifestText | Requerido | Texto de Manifiesto. |
| B64ManifestSignature | Sello (Requerido) | Sello del texto de Manifiesto. |
| SendEmail | Requerido | Se especifica si se enviara el documento del Manifiesto por correo. |
| Requerido | Correo electrónico a donde llegara el Manifiesto ya firmado. |
Ejemplo Request
curl --location --request PUT 'https://api.test.sw.com.mx/management/v2/api/dealers/manifests' \
--header 'Authorization: bearer token' \
--header 'Content-Type: application/json' \
--data-raw '{
"B64Cer":"MIIF0TCCA7mgAwIBAgIUMzA",
"B64ManifestText":"UG9yIG1lZGlvIG",
"B64ManifestSignature":"EyMAa4VuNizObpS4=",
"SendEmail":true,
"Email":"correo@correo.com"
}'
Ejemplo Response
La respuesta exitosa sera el archivo pdf del Manifiesto firmado.
{
"message": "El certificado publico no es base64",
"status": "error"
}
| Atributo | Tipo | Descripción |
|---|---|---|
| message | String | mensaje regresado cuando existe un error. |
| status | String | “error” |
En SW® somos mejores para TI, es por ello que tu opinión es muy importante, por favor ayúdanos calificando este articulo y dejando tus comentarios.