1. Home
  2. SW API´S
  3. API Firma de Manifiesto

API Firma de Manifiesto

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étodoRuta
POST/management/v2/api/dealers/manifests

Autenticación y Headers

HeaderValue
AuthorizationBearer Token
Content-Typeapplication/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
Email 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

Response Ok
La respuesta exitosa sera el archivo pdf del Manifiesto firmado.
Response Error
{
    "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étodoRuta
PATCH/management/v2/api/dealers/manifests

Autenticación y Headers

HeaderValue
AuthorizationBearer Token
Content-Typeapplication/json

Parámetros JSON

PropiedadUsoDescripción
B64CerRequeridoCertificado 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

Response Ok
{
    "data": {
        "rfc": null,
        "company_name": null,
        "contentB64": "UG9yIG1lZGlvIGRlbCBwcmVzZW50ZSwgWE9DSElMVCBDQVNBUyBDSEFWRVosIGNvbiBSRkMgQ0FDWDc2MDUxMDFQOCwgbWFuaWZpZXN0byBtaSBjb25mb3JtaWRhZCB5IGF1dG9yaXphY2nDs24gcGFyYSBxdWUgbGEgZW1wcmVzYSBMVU5BIFNPRlQsUy5BLiBERSBDLlYuLCBQcm92ZWVkb3IgQXV0b3JpemFkbyBkZSBDZXJ0aWZpY2FjacOzbiBkZSBDRkRJIGNvbiBuw7ptZXJvIGRlIGF1dG9yaXphY2nDs24gMTY1NDMsIHByb2NlZGEgYSBlbnRyZWdhciBhbCBTZXJ2aWNpbyBkZSBBZG1pbmlzdHJhY2nDs24gVHJpYnV0YXJpYSwgY29waWEgZGUgbG9zIGNvbXByb2JhbnRlcyBmaXNjYWxlcyBxdWUgbWUgaGF5YSBjZXJ0aWZpY2FkbywgZGUgYWN1ZXJkbyBhIGxvIGVzdGFibGVjaWRvIGVuIGxhIHJlZ2xhIDIuNy4yLjcgZGUgbGEgUmVzb2x1Y2nDs24gTWlzY2Vsw6FuZWEgRmlzY2FsIHBhcmEgMjAxOSBwdWJsaWNhZGEgZW4gZWwgRGlhcmlvIE9maWNpYWwgZGUgbGEgRmVkZXJhY2nDs24gZWwgMjkgZGUgQWJyaWwgZGUgMjAxOS4gQWwgbWlzbW8gdGllbXBvIGFjZXB0byBxdWUgZW1wcmVzYSBMVU5BIFNPRlQsIFMuQS4gREUgQy5WLiwgc2VhIHF1aWVuIG1lIHByb3BvcmNpb25lIGEgbWkgbm9tYnJlIG8gYWwgZGUgbWkgcmVwcmVzZW50YWRhLCBlbCAqU2VydmljaW8gZGUgQ2VydGlmaWNhY2nDs24gcGFyYSB0b2RvcyBsb3MgQ29tcHJvYmFudGVzIEZpc2NhbGVzIERpZ2l0YWxlcyBwb3IgSW50ZXJuZXQgKENGREkpIHF1ZSBlbWl0YSBjb21vIHBlcnNvbmEgZsOtc2ljYSBvIGNvbW8gcGVyc29uYSBtb3JhbC4gKlNlcnZpY2lvIGRlIENlcnRpZmljYWNpw7NuOiBzZSByZWZpZXJlIGEgdmFsaWRhY2nDs24geSB0aW1icmFkbyBkZSBDb21wcm9iYW50ZXMgRmlzY2FsZXMgRGlnaXRhbGVzIHBvciBJbnRlcm5ldCAoQ0ZESSku",
        "contentBytesSize": 921
    },
    "meta": null,
    "links": null,
    "status": "success"
}
Response Error
{
    "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étodoRuta
PUT/management/v2/api/dealers/manifests

Autenticación y Headers

HeaderValue
AuthorizationBearer Token
Content-Typeapplication/json

Parámetros JSON

PropiedadUsoDescripción
B64CerRequeridoCertificado en base 64.
B64ManifestTextRequeridoTexto de Manifiesto
B64ManifestSignatureSello (Requerido)Sello del texto de Manifiesto
SendEmailRequeridoSe especifica si se enviara el documento del Manifiesto por correo
EmailRequeridoCorreo 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

Response Ok
La respuesta exitosa sera el archivo pdf del Manifiesto firmado.
Response Error
{
    "message": "El certificado publico no es base64",
    "status": "error"
}

En SW® somos mejores para TI, es por ello que tu opinión es muy importantepor favor ayúdanos calificando este articulo y dejando tus comentarios.

How useful was this post?

Click on a star to rate it!

We are sorry that this post was not useful for you!

Let us improve this post!

Tell us how we can improve this post?

Updated on octubre 10, 2024

Article Attachments

Related Articles