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 Pruebas : https://api.test.sw.com.mx
🧰 Url Producción : 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 | Ruta |
---|---|
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 electronico 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" }
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" }
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 electronico 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" }
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.