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.