Timbrado V4 – Pdf

Servicio de timbrado que recibe un comprobante CFDI, incluyendo sus complementos, y es compatible con la versión vigente. Permite la certificación del comprobante y admite un encabezado adicional llamado extra, el cual indica si se debe generar el PDF del CFDI timbrado y almacenarlo automáticamente en el portal ADT.
En ambiente de pruebas se permite el uso de certificados reales, aunque se recomienda utilizar los CSD de pruebas.

💡Nota Importante: 👉 Por motivos de compatibilidad, aunque el path de nuestros servicios indique /cfdi33, este mismo endpoint acepta la versión actual del CFDI.

URL´s

🛠️ Pruebas:
🚀 Productivo:

Emisión Timbrado

Servicio de timbrado que sella y timbra un comprobante CFDI 4.0 en formato XML. Es requerido cargar los certificados del emisor previamente a la cuenta de timbrado.

🔗 Endpoint

MétodoRuta
POST/v4/cfdi33/issue/{version}/{format}

🔐 Autenticación y Headers

HeaderValue
AuthorizationBearer Token
Content-Typemultipart/form-data
extrapdf

📍 Parámetros Path

PropiedadUsoDescripción
versionRequeridoVersión de la respuesta que devolverá el servicio.
formatOpcional(Default=b64) Parámetro para especificar si el XML esta en formato base 64.

🧾 Parámetros Form

PropiedadUsoDescripción
xmlRequeridoXML del comprobante a ser timbrado.

Ejemplo Request

curl --request POST \
  --url http://services.test.sw.com.mx/v4/cfdi33/issue/v4 \
  --header 'Authorization: Bearer $token' \
  --header 'Content-Type: multipart/form-data; boundary=--
-011000010111000001101001' \
  --header 'extra: pdf'\
  --form 'xml=cfdi.xml'

Ejemplo Response

{
    "data": {
        "cfdi": "<?xml version=\"1.0\" encoding=\"utf-8\"?><cfdi:Comprobante xsi:schemaLocation=\"http://www.sat.gob.mx/cfd/3 http://www.sat.gob.mx/sitio_internet/cfd/3/cfdv33.xsd\" Version=\"3.3\" Serie=\"RogueOne\" Folio=\"HNFK231\" Fecha=\"2022-08-01T00:00:01\" Sello=\"LSuoAJ/KDctbDzv2d0dycfUc60brBz97R8AL/J4IjVrhMKSKH2peAY7hN1NGESMhKiBXzlZZsfQ9Pl2TbQFGJalPfnmFKyluhlWIwvd6+qL8aJf3rJdPIkjBfUMW3sUq2A3OclCATO5cMBWLOU2gGd/dm6Ag9wZmofpuqepwP/YCzuG/ehAo5SpcbTgy9GxufjrcywXHAFpShpokJE2o/l1/GyLx+9qv7Ex9272tKM5JcGomH+dBpyD4J4Z9r5kLJA0JquPLOvAnuGSCtMr92l0gB4OB5a77eMqsrZb3dvfHN1bK07LkPc9GP4dAviRqZt7U0nQoOvbRRA9Z0dOewA==\" FormaPago=\"01\" NoCertificado=\"30001000000400002434\" Certificado=\"MIIFuzCCA6OgAwIBAgIUMzAwMDEwMDAwMDA0MDAwMDI0MzQwDQYJKoZIhvcNAQELBQAwggErMQ8wDQYDVQQDDAZBQyBVQVQxLjAsBgNVBAoMJVNFUlZJQ0lPIERFIEFETUlOSVNUUkFDSU9OIFRSSUJVVEFSSUExGjAYBgNVBAsMEVNBVC1JRVMgQXV0aG9yaXR5MSgwJgYJKoZIhvcNAQkBFhlvc2Nhci5tYXJ0aW5lekBzYXQuZ29iLm14MR0wGwYDVQQJDBQzcmEgY2VycmFkYSBkZSBjYWRpejEOMAwGA1UEEQwFMDYzNzAxCzAJBgNVBAYTAk1YMRkwFwYDVQQIDBBDSVVEQUQgREUgTUVYSUNPMREwDwYDVQQHDAhDT1lPQUNBTjERMA8GA1UELRMIMi41LjQuNDUxJTAjBgkqhkiG9w0BCQITFnJlc3BvbnNhYmxlOiBBQ0RNQS1TQVQwHhcNMTkwNjE3MTk0NDE0WhcNMjMwNjE3MTk0NDE0WjCB4jEnMCUGA1UEAxMeRVNDVUVMQSBLRU1QRVIgVVJHQVRFIFNBIERFIENWMScwJQYDVQQpEx5FU0NVRUxBIEtFTVBFUiBVUkdBVEUgU0EgREUgQ1YxJzAlBgNVBAoTHkVTQ1VFTEEgS0VNUEVSIFVSR0FURSBTQSBERSBDVjElMCMGA1UELRMcRUtVOTAwMzE3M0M5IC8gWElRQjg5MTExNlFFNDEeMBwGA1UEBRMVIC8gWElRQjg5MTExNk1HUk1aUjA1MR4wHAYDVQQLExVFc2N1ZWxhIEtlbXBlciBVcmdhdGUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCN0peKpgfOL75iYRv1fqq+oVYsLPVUR/GibYmGKc9InHFy5lYF6OTYjnIIvmkOdRobbGlCUxORX/tLsl8Ya9gm6Yo7hHnODRBIDup3GISFzB/96R9K/MzYQOcscMIoBDARaycnLvy7FlMvO7/rlVnsSARxZRO8Kz8Zkksj2zpeYpjZIya/369+oGqQk1cTRkHo59JvJ4Tfbk/3iIyf4H/Ini9nBe9cYWo0MnKob7DDt/vsdi5tA8mMtA953LapNyCZIDCRQQlUGNgDqY9/8F5mUvVgkcczsIgGdvf9vMQPSf3jjCiKj7j6ucxl1+FwJWmbvgNmiaUR/0q4m2rm78lFAgMBAAGjHTAbMAwGA1UdEwEB/wQCMAAwCwYDVR0PBAQDAgbAMA0GCSqGSIb3DQEBCwUAA4ICAQBcpj1TjT4jiinIujIdAlFzE6kRwYJCnDG08zSp4kSnShjxADGEXH2chehKMV0FY7c4njA5eDGdA/G2OCTPvF5rpeCZP5Dw504RZkYDl2suRz+wa1sNBVpbnBJEK0fQcN3IftBwsgNFdFhUtCyw3lus1SSJbPxjLHS6FcZZ51YSeIfcNXOAuTqdimusaXq15GrSrCOkM6n2jfj2sMJYM2HXaXJ6rGTEgYmhYdwxWtil6RfZB+fGQ/H9I9WLnl4KTZUS6C9+NLHh4FPDhSk19fpS2S/56aqgFoGAkXAYt9Fy5ECaPcULIfJ1DEbsXKyRdCv3JY89+0MNkOdaDnsemS2o5Gl08zI4iYtt3L40gAZ60NPh31kVLnYNsmvfNxYyKp+AeJtDHyW9w7ftM0Hoi+BuRmcAQSKFV3pk8j51la+jrRBrAUv8blbRcQ5BiZUwJzHFEKIwTsRGoRyEx96sNnB03n6GTwjIGz92SmLdNl95r9rkvp+2m4S6q1lPuXaFg7DGBrXWC8iyqeWE2iobdwIIuXPTMVqQb12m1dAkJVRO5NdHnP/MpqOvOgLqoZBNHGyBg4Gqm4sCJHCxA1c8Elfa2RQTCk0tAzllL4vOnI1GHkGJn65xokGsaU4B4D36xh7eWrfj4/pgWHmtoDAYa8wzSwo2GVCZOs+mtEgOQB91/g==\" SubTotal=\"200.00\" Moneda=\"MXN\" TipoCambio=\"1\" Total=\"603.20\" TipoDeComprobante=\"I\" MetodoPago=\"PUE\" LugarExpedicion=\"06300\" xmlns:cfdi=\"http://www.sat.gob.mx/cfd/3\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"><cfdi:Emisor Rfc=\"EKU9003173C9\" Nombre=\"MB IDEAS DIGITALES SC\" RegimenFiscal=\"601\" /><cfdi:Receptor Rfc=\"AAA010101AAA\" Nombre=\"SW SMARTERWEB\" UsoCFDI=\"G03\" /><cfdi:Conceptos><cfdi:Concepto ClaveProdServ=\"50211503\" NoIdentificacion=\"UT421511\" Cantidad=\"1\" ClaveUnidad=\"H87\" Unidad=\"Pieza\" Descripcion=\"Cigarros\" ValorUnitario=\"200.00\" Importe=\"200.00\"><cfdi:Impuestos><cfdi:Traslados><cfdi:Traslado Base=\"200.00\" Impuesto=\"002\" TipoFactor=\"Tasa\" TasaOCuota=\"0.160000\" Importe=\"32.00\" /><cfdi:Traslado Base=\"232.00\" Impuesto=\"003\" TipoFactor=\"Tasa\" TasaOCuota=\"1.600000\" Importe=\"371.20\" /></cfdi:Traslados></cfdi:Impuestos></cfdi:Concepto></cfdi:Conceptos><cfdi:Impuestos TotalImpuestosTrasladados=\"403.20\"><cfdi:Traslados><cfdi:Traslado Impuesto=\"002\" TipoFactor=\"Tasa\" TasaOCuota=\"0.160000\" Importe=\"32.00\" /><cfdi:Traslado Impuesto=\"003\" TipoFactor=\"Tasa\" TasaOCuota=\"1.600000\" Importe=\"371.20\" /></cfdi:Traslados></cfdi:Impuestos><cfdi:Complemento><tfd:TimbreFiscalDigital xsi:schemaLocation=\"http://www.sat.gob.mx/TimbreFiscalDigital http://www.sat.gob.mx/sitio_internet/cfd/TimbreFiscalDigital/TimbreFiscalDigitalv11.xsd\" Version=\"1.1\" UUID=\"418dc475-fa8a-427f-8081-8db755a9c0d1\" FechaTimbrado=\"2022-08-01T12:17:43\" RfcProvCertif=\"SPR190613I52\" SelloCFD=\"LSuoAJ/KDctbDzv2d0dycfUc60brBz97R8AL/J4IjVrhMKSKH2peAY7hN1NGESMhKiBXzlZZsfQ9Pl2TbQFGJalPfnmFKyluhlWIwvd6+qL8aJf3rJdPIkjBfUMW3sUq2A3OclCATO5cMBWLOU2gGd/dm6Ag9wZmofpuqepwP/YCzuG/ehAo5SpcbTgy9GxufjrcywXHAFpShpokJE2o/l1/GyLx+9qv7Ex9272tKM5JcGomH+dBpyD4J4Z9r5kLJA0JquPLOvAnuGSCtMr92l0gB4OB5a77eMqsrZb3dvfHN1bK07LkPc9GP4dAviRqZt7U0nQoOvbRRA9Z0dOewA==\" NoCertificadoSAT=\"30001000000400002495\" SelloSAT=\"r6teOUjkUnX+LnJuGt/wPuxZlBp9Y6MlvesQkCS9C1LzadVCg+Usb9J9ex/qgb7GkOX+D31vAvbt9USV9u+m2UAlE5SY2uv3NNL3NZVwjiqi+zuR/P8EGS3rlW0IoZgtpugcPhu+PrEkI9fazVWUE0AZ4ZVs1zisvF7eSI2IJcHb7ZNdanBjXfYKwKizuhwyfdFpE37YY2mdldZ5fUx9XQW6KvDKxRuzCe1Y3fKDX6alcmb+fEOJjGkTZbTaOfsk4Spp2a/fa/sg1s48aM3VEdgm3gqgXGcy+ZKB2b72ZjVYuZuAeBrqX7aFctcVbScfq4DWEyWdjDRYcYIRJbWSWQ==\" xmlns:tfd=\"http://www.sat.gob.mx/TimbreFiscalDigital\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" /></cfdi:Complemento></cfdi:Comprobante>"
    },
    "status": "success"
}
{
    "message": "Xml CFDI33 no proporcionado o viene vacio.",
    "messageDetail": null,
    "data": null,
    "status": "error"
}
AtributoTipoDescripción
messageStringCódigo regresado cuando existe un error.
messageDetailStringMensaje más descriptivo del error cuando existe uno.
dataobject/nullObjeto de datos referente al timbrado cuando es exitoso. Los parámetros varían según la versión de respuesta.
statusString“success” o “error”

Emisión Timbrado JSON

Servicio de timbrado que sella y timbra un comprobante CFDI 4.0 en formato JSON. Es requerido cargar los certificados del emisor previamente a la cuenta de timbrado.

🔗 Endpoint

MetodoRuta
POST/v4/cfdi33/issue/json/{version}

🔐 Autenticación y Headers

HeaderValue
AuthorizationBearer Token
Content-Typeapplication/jsontoxml
extrapdf

📍 Parámetros Path

PropiedadUsoDescripción
versionRequeridoVersión de la respuesta que devolverá el servicio.

🧾 Parámetros JSON

PropiedadUsoDescripción
dataRequeridoJSON del comprobante a ser timbrado.

Ejemplo Request

curl --request POST \
  --url http://services.test.sw.com.mx/v4/cfdi33/issue/json/v4 \
  --header 'Authorization: Bearer $token' \
  --header 'Content-Type: application/json' \
  --header 'extra: pdf'\
  --data "{\n   \"Version\":\"4.0\",\n   \"FormaPago\":\"01\",\n....}"

Ejemplo Response

{
    "data": {
        "cfdi": "<?xml version=\"1.0\" encoding=\"utf-8\"?><cfdi:Comprobante xsi:schemaLocation=\"http://www.sat.gob.mx/cfd/4 http://www.sat.gob.mx/sitio_internet/cfd/4/cfdv40.xsd\" Version=\"4.0\" Serie=\"SW\" Folio=\"123456\" Fecha=\"2022-08-01T00:00:00\" Sello=\"PPLGBqFhsM2WE3G0pkbcrTruYoRA3gqn6fR+af5CUxSK5Vbi5PRzePcX2qEM59kDLue7az/2I+5dw7atmAfnp5lSFVZGLhxll8x/UJc/Os3mTFjeP5r0G6pvnLdss9h+XhrmyclzeT+urmJ9SnFTXVvk9vUjUsNZEH8acz7sscoWiT9hhUI8t3H9UpbnLZ69yRM0y0NdbMkr9boT0VDPNpUDg19ToXBGcX+hmL81MumvW9kksKLMfB9I6AeUuH9ZcnOilQKFOQddTqizSN3fo3EnrQEsdghf0fnqMHnzbXm1d3vOCfS7QDmh3Oe6iXvMCKLbqwbC8jXcJzJp+3XxQg==\" FormaPago=\"01\" NoCertificado=\"30001000000400002434\" Certificado=\"MIIFuzCCA6OgAwIBAgIUMzAwMDEwMDAwMDA0MDAwMDI0MzQwDQYJKoZIhvcNAQELBQAwggErMQ8wDQYDVQQDDAZBQyBVQVQxLjAsBgNVBAoMJVNFUlZJQ0lPIERFIEFETUlOSVNUUkFDSU9OIFRSSUJVVEFSSUExGjAYBgNVBAsMEVNBVC1JRVMgQXV0aG9yaXR5MSgwJgYJKoZIhvcNAQkBFhlvc2Nhci5tYXJ0aW5lekBzYXQuZ29iLm14MR0wGwYDVQQJDBQzcmEgY2VycmFkYSBkZSBjYWRpejEOMAwGA1UEEQwFMDYzNzAxCzAJBgNVBAYTAk1YMRkwFwYDVQQIDBBDSVVEQUQgREUgTUVYSUNPMREwDwYDVQQHDAhDT1lPQUNBTjERMA8GA1UELRMIMi41LjQuNDUxJTAjBgkqhkiG9w0BCQITFnJlc3BvbnNhYmxlOiBBQ0RNQS1TQVQwHhcNMTkwNjE3MTk0NDE0WhcNMjMwNjE3MTk0NDE0WjCB4jEnMCUGA1UEAxMeRVNDVUVMQSBLRU1QRVIgVVJHQVRFIFNBIERFIENWMScwJQYDVQQpEx5FU0NVRUxBIEtFTVBFUiBVUkdBVEUgU0EgREUgQ1YxJzAlBgNVBAoTHkVTQ1VFTEEgS0VNUEVSIFVSR0FURSBTQSBERSBDVjElMCMGA1UELRMcRUtVOTAwMzE3M0M5IC8gWElRQjg5MTExNlFFNDEeMBwGA1UEBRMVIC8gWElRQjg5MTExNk1HUk1aUjA1MR4wHAYDVQQLExVFc2N1ZWxhIEtlbXBlciBVcmdhdGUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCN0peKpgfOL75iYRv1fqq+oVYsLPVUR/GibYmGKc9InHFy5lYF6OTYjnIIvmkOdRobbGlCUxORX/tLsl8Ya9gm6Yo7hHnODRBIDup3GISFzB/96R9K/MzYQOcscMIoBDARaycnLvy7FlMvO7/rlVnsSARxZRO8Kz8Zkksj2zpeYpjZIya/369+oGqQk1cTRkHo59JvJ4Tfbk/3iIyf4H/Ini9nBe9cYWo0MnKob7DDt/vsdi5tA8mMtA953LapNyCZIDCRQQlUGNgDqY9/8F5mUvVgkcczsIgGdvf9vMQPSf3jjCiKj7j6ucxl1+FwJWmbvgNmiaUR/0q4m2rm78lFAgMBAAGjHTAbMAwGA1UdEwEB/wQCMAAwCwYDVR0PBAQDAgbAMA0GCSqGSIb3DQEBCwUAA4ICAQBcpj1TjT4jiinIujIdAlFzE6kRwYJCnDG08zSp4kSnShjxADGEXH2chehKMV0FY7c4njA5eDGdA/G2OCTPvF5rpeCZP5Dw504RZkYDl2suRz+wa1sNBVpbnBJEK0fQcN3IftBwsgNFdFhUtCyw3lus1SSJbPxjLHS6FcZZ51YSeIfcNXOAuTqdimusaXq15GrSrCOkM6n2jfj2sMJYM2HXaXJ6rGTEgYmhYdwxWtil6RfZB+fGQ/H9I9WLnl4KTZUS6C9+NLHh4FPDhSk19fpS2S/56aqgFoGAkXAYt9Fy5ECaPcULIfJ1DEbsXKyRdCv3JY89+0MNkOdaDnsemS2o5Gl08zI4iYtt3L40gAZ60NPh31kVLnYNsmvfNxYyKp+AeJtDHyW9w7ftM0Hoi+BuRmcAQSKFV3pk8j51la+jrRBrAUv8blbRcQ5BiZUwJzHFEKIwTsRGoRyEx96sNnB03n6GTwjIGz92SmLdNl95r9rkvp+2m4S6q1lPuXaFg7DGBrXWC8iyqeWE2iobdwIIuXPTMVqQb12m1dAkJVRO5NdHnP/MpqOvOgLqoZBNHGyBg4Gqm4sCJHCxA1c8Elfa2RQTCk0tAzllL4vOnI1GHkGJn65xokGsaU4B4D36xh7eWrfj4/pgWHmtoDAYa8wzSwo2GVCZOs+mtEgOQB91/g==\" CondicionesDePago=\"CondicionesDePago\" SubTotal=\"10.00\" Descuento=\"0.00\" Moneda=\"AMD\" TipoCambio=\"1\" Total=\"10.00\" TipoDeComprobante=\"I\" Exportacion=\"01\" MetodoPago=\"PUE\" LugarExpedicion=\"45610\" xmlns:cfdi=\"http://www.sat.gob.mx/cfd/4\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"><cfdi:Emisor Rfc=\"EKU9003173C9\" Nombre=\"ESCUELA KEMPER URGATE\" RegimenFiscal=\"603\" /><cfdi:Receptor Rfc=\"EKU9003173C9\" Nombre=\"ESCUELA KEMPER URGATE\" DomicilioFiscalReceptor=\"26015\" RegimenFiscalReceptor=\"601\" UsoCFDI=\"CP01\" /><cfdi:Conceptos><cfdi:Concepto ClaveProdServ=\"50211503\" NoIdentificacion=\"None\" Cantidad=\"1.0\" ClaveUnidad=\"H87\" Unidad=\"Pieza\" Descripcion=\"Cigarros\" ValorUnitario=\"10.00\" Importe=\"10.00\" Descuento=\"0.00\" ObjetoImp=\"02\"><cfdi:Impuestos><cfdi:Traslados><cfdi:Traslado Base=\"1\" Impuesto=\"002\" TipoFactor=\"Tasa\" TasaOCuota=\"0.160000\" Importe=\"1\" /></cfdi:Traslados><cfdi:Retenciones><cfdi:Retencion Base=\"1\" Impuesto=\"002\" TipoFactor=\"Tasa\" TasaOCuota=\"0.040000\" Importe=\"1\" /></cfdi:Retenciones></cfdi:Impuestos></cfdi:Concepto></cfdi:Conceptos><cfdi:Impuestos TotalImpuestosRetenidos=\"1.00\" TotalImpuestosTrasladados=\"1.00\"><cfdi:Retenciones><cfdi:Retencion Impuesto=\"002\" Importe=\"1.00\" /></cfdi:Retenciones><cfdi:Traslados><cfdi:Traslado Base=\"1.00\" Impuesto=\"002\" TipoFactor=\"Tasa\" TasaOCuota=\"0.160000\" Importe=\"1.00\" /></cfdi:Traslados></cfdi:Impuestos><cfdi:Complemento><tfd:TimbreFiscalDigital xsi:schemaLocation=\"http://www.sat.gob.mx/TimbreFiscalDigital http://www.sat.gob.mx/sitio_internet/cfd/TimbreFiscalDigital/TimbreFiscalDigitalv11.xsd\" Version=\"1.1\" UUID=\"94642166-8e32-4e70-93ec-c91f2586f4d8\" FechaTimbrado=\"2022-08-01T12:27:31\" RfcProvCertif=\"SPR190613I52\" SelloCFD=\"PPLGBqFhsM2WE3G0pkbcrTruYoRA3gqn6fR+af5CUxSK5Vbi5PRzePcX2qEM59kDLue7az/2I+5dw7atmAfnp5lSFVZGLhxll8x/UJc/Os3mTFjeP5r0G6pvnLdss9h+XhrmyclzeT+urmJ9SnFTXVvk9vUjUsNZEH8acz7sscoWiT9hhUI8t3H9UpbnLZ69yRM0y0NdbMkr9boT0VDPNpUDg19ToXBGcX+hmL81MumvW9kksKLMfB9I6AeUuH9ZcnOilQKFOQddTqizSN3fo3EnrQEsdghf0fnqMHnzbXm1d3vOCfS7QDmh3Oe6iXvMCKLbqwbC8jXcJzJp+3XxQg==\" NoCertificadoSAT=\"30001000000400002495\" SelloSAT=\"i6U7sTyBx1vrU60bnxgn0By0xiylYbR/k0RQBV55rxBxre/Us8pt3/WSEd3AlVSBJHN4R+bc1NPV2r+4x9ktdYjnaXbp6PW5cfjdes4zFdty0GSgU8BJor8bceG2R/j29bOxlydEND71Vf7+GvbhPOZtwSOEZilIH9xJdlZVC1lJyRr40q+5VDc5cw+Y+ghcbjeqpdoOaRptJ0A/UVzA2ZUpR5H7EFz3EGlobZTi7UkOJ9Ctwh8aTA9tB7WmvuIiPs/t7KhBlCKhkot8joSiCVp+EoPX6UraQY6brxKzx/+tdnlz0+Dk8ZnIPSjBfW2woi5AC77HbZI7dxGx84x62g==\" xmlns:tfd=\"http://www.sat.gob.mx/TimbreFiscalDigital\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" /></cfdi:Complemento></cfdi:Comprobante>"
    },
    "status": "success"
}
{
    "message": "Xml CFDI33 no proporcionado o viene vacio.",
    "messageDetail": null,
    "data": null,
    "status": "error"
}
AtributoTipoDescripción
messageStringCódigo regresado cuando existe un error.
messageDetailStringMensaje más descriptivo del error cuando existe uno.
dataobject/nullObjeto de datos referente al timbrado cuando es exitoso. Los parámetros varían según la versión de respuesta.
statusString“success” o “error”

Timbrado

Servicio de timbrado que timbra un comprobante CFDI 4.0 previamente sellado en formato XML.

🔗 Endpoint

MétodoRuta
POST/v4/cfdi33/stamp/{version}/{format}

🔐 Autenticación y Headers

HeaderValue
AuthorizationBearer Token
Content-Typemultipart/form-data
extrapdf

📍 Parámetros Path

PropiedadUsoDescripción
versionRequeridoVersión de la respuesta que devolverá el servicio.
formatOpcional (Default=b64) Parámetro para especificar si el XML esta en formato base 64.

🧾 Parámetros Form

PropiedadUsoDescripción
xmlRequeridoXML del comprobante a ser timbrado.

Ejemplo Request

curl --request POST \
  --url http://services.test.sw.com.mx/v4/cfdi33/stamp/v4 \
  --header 'Authorization: Bearer $token' \
  --header 'Content-Type: multipart/form-data; boundary=--
-011000010111000001101001' \
  --header 'extra: pdf'\
  --form 'xml=cfdi.xml'

Ejemplo Response

{
    "data": {
        "cfdi": "<?xml version=\"1.0\" encoding=\"utf-8\"?><cfdi:Comprobante xsi:schemaLocation=\"http://www.sat.gob.mx/cfd/3 http://www.sat.gob.mx/sitio_internet/cfd/3/cfdv33.xsd\" Version=\"3.3\" Serie=\"RogueOne\" Folio=\"HNFK231\" Fecha=\"2022-08-01T00:00:00\" Sello=\"HA9AAQQHSlQjM1F6Okx/I1e9DrUcToeYc//TcZZAPCiPwdA+wwDvyJmWm2RFS/uwurtG4ilzw9Nc9WX2k+iQF342G4NGGzkNGCsJI5oheS0+KelZfmtnSov1wcrWYfZ54LiacRUDgxl7iXC6yQjd6QfPtjeIibhZ8fuEq/tPuq9FeicrWi4EBXCtSx8KD5tWNSgkkQceRATy26UaIOXG9IlVBrVsRqA9rP2SA+SlbgFKS5WYpC9zXqFzAVv82+pKh9C9/t6DU6QMZL0VRglyniwzSKgbzUz3JCCIsDlTmoKNCrjXzhpLaZ5XCdYDrOFK1RAJe1eCLfz6Aib1mwNQxg==\" FormaPago=\"01\" NoCertificado=\"30001000000400002434\" Certificado=\"MIIFuzCCA6OgAwIBAgIUMzAwMDEwMDAwMDA0MDAwMDI0MzQwDQYJKoZIhvcNAQELBQAwggErMQ8wDQYDVQQDDAZBQyBVQVQxLjAsBgNVBAoMJVNFUlZJQ0lPIERFIEFETUlOSVNUUkFDSU9OIFRSSUJVVEFSSUExGjAYBgNVBAsMEVNBVC1JRVMgQXV0aG9yaXR5MSgwJgYJKoZIhvcNAQkBFhlvc2Nhci5tYXJ0aW5lekBzYXQuZ29iLm14MR0wGwYDVQQJDBQzcmEgY2VycmFkYSBkZSBjYWRpejEOMAwGA1UEEQwFMDYzNzAxCzAJBgNVBAYTAk1YMRkwFwYDVQQIDBBDSVVEQUQgREUgTUVYSUNPMREwDwYDVQQHDAhDT1lPQUNBTjERMA8GA1UELRMIMi41LjQuNDUxJTAjBgkqhkiG9w0BCQITFnJlc3BvbnNhYmxlOiBBQ0RNQS1TQVQwHhcNMTkwNjE3MTk0NDE0WhcNMjMwNjE3MTk0NDE0WjCB4jEnMCUGA1UEAxMeRVNDVUVMQSBLRU1QRVIgVVJHQVRFIFNBIERFIENWMScwJQYDVQQpEx5FU0NVRUxBIEtFTVBFUiBVUkdBVEUgU0EgREUgQ1YxJzAlBgNVBAoTHkVTQ1VFTEEgS0VNUEVSIFVSR0FURSBTQSBERSBDVjElMCMGA1UELRMcRUtVOTAwMzE3M0M5IC8gWElRQjg5MTExNlFFNDEeMBwGA1UEBRMVIC8gWElRQjg5MTExNk1HUk1aUjA1MR4wHAYDVQQLExVFc2N1ZWxhIEtlbXBlciBVcmdhdGUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCN0peKpgfOL75iYRv1fqq+oVYsLPVUR/GibYmGKc9InHFy5lYF6OTYjnIIvmkOdRobbGlCUxORX/tLsl8Ya9gm6Yo7hHnODRBIDup3GISFzB/96R9K/MzYQOcscMIoBDARaycnLvy7FlMvO7/rlVnsSARxZRO8Kz8Zkksj2zpeYpjZIya/369+oGqQk1cTRkHo59JvJ4Tfbk/3iIyf4H/Ini9nBe9cYWo0MnKob7DDt/vsdi5tA8mMtA953LapNyCZIDCRQQlUGNgDqY9/8F5mUvVgkcczsIgGdvf9vMQPSf3jjCiKj7j6ucxl1+FwJWmbvgNmiaUR/0q4m2rm78lFAgMBAAGjHTAbMAwGA1UdEwEB/wQCMAAwCwYDVR0PBAQDAgbAMA0GCSqGSIb3DQEBCwUAA4ICAQBcpj1TjT4jiinIujIdAlFzE6kRwYJCnDG08zSp4kSnShjxADGEXH2chehKMV0FY7c4njA5eDGdA/G2OCTPvF5rpeCZP5Dw504RZkYDl2suRz+wa1sNBVpbnBJEK0fQcN3IftBwsgNFdFhUtCyw3lus1SSJbPxjLHS6FcZZ51YSeIfcNXOAuTqdimusaXq15GrSrCOkM6n2jfj2sMJYM2HXaXJ6rGTEgYmhYdwxWtil6RfZB+fGQ/H9I9WLnl4KTZUS6C9+NLHh4FPDhSk19fpS2S/56aqgFoGAkXAYt9Fy5ECaPcULIfJ1DEbsXKyRdCv3JY89+0MNkOdaDnsemS2o5Gl08zI4iYtt3L40gAZ60NPh31kVLnYNsmvfNxYyKp+AeJtDHyW9w7ftM0Hoi+BuRmcAQSKFV3pk8j51la+jrRBrAUv8blbRcQ5BiZUwJzHFEKIwTsRGoRyEx96sNnB03n6GTwjIGz92SmLdNl95r9rkvp+2m4S6q1lPuXaFg7DGBrXWC8iyqeWE2iobdwIIuXPTMVqQb12m1dAkJVRO5NdHnP/MpqOvOgLqoZBNHGyBg4Gqm4sCJHCxA1c8Elfa2RQTCk0tAzllL4vOnI1GHkGJn65xokGsaU4B4D36xh7eWrfj4/pgWHmtoDAYa8wzSwo2GVCZOs+mtEgOQB91/g==\" SubTotal=\"200.00\" Moneda=\"MXN\" TipoCambio=\"1\" Total=\"603.20\" TipoDeComprobante=\"I\" MetodoPago=\"PUE\" LugarExpedicion=\"06300\" xmlns:cfdi=\"http://www.sat.gob.mx/cfd/3\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"><cfdi:Emisor Rfc=\"EKU9003173C9\" Nombre=\"MB IDEAS DIGITALES SC\" RegimenFiscal=\"601\" /><cfdi:Receptor Rfc=\"AAA010101AAA\" Nombre=\"SW SMARTERWEB\" UsoCFDI=\"G03\" /><cfdi:Conceptos><cfdi:Concepto ClaveProdServ=\"50211503\" NoIdentificacion=\"UT421511\" Cantidad=\"1\" ClaveUnidad=\"H87\" Unidad=\"Pieza\" Descripcion=\"Cigarros\" ValorUnitario=\"200.00\" Importe=\"200.00\"><cfdi:Impuestos><cfdi:Traslados><cfdi:Traslado Base=\"200.00\" Impuesto=\"002\" TipoFactor=\"Tasa\" TasaOCuota=\"0.160000\" Importe=\"32.00\" /><cfdi:Traslado Base=\"232.00\" Impuesto=\"003\" TipoFactor=\"Tasa\" TasaOCuota=\"1.600000\" Importe=\"371.20\" /></cfdi:Traslados></cfdi:Impuestos></cfdi:Concepto></cfdi:Conceptos><cfdi:Impuestos TotalImpuestosTrasladados=\"403.20\"><cfdi:Traslados><cfdi:Traslado Impuesto=\"002\" TipoFactor=\"Tasa\" TasaOCuota=\"0.160000\" Importe=\"32.00\" /><cfdi:Traslado Impuesto=\"003\" TipoFactor=\"Tasa\" TasaOCuota=\"1.600000\" Importe=\"371.20\" /></cfdi:Traslados></cfdi:Impuestos><cfdi:Complemento><tfd:TimbreFiscalDigital xsi:schemaLocation=\"http://www.sat.gob.mx/TimbreFiscalDigital http://www.sat.gob.mx/sitio_internet/cfd/TimbreFiscalDigital/TimbreFiscalDigitalv11.xsd\" Version=\"1.1\" UUID=\"660e24f8-a90d-4dee-9c1d-50bcd9710249\" FechaTimbrado=\"2022-08-01T12:11:37\" RfcProvCertif=\"SPR190613I52\" SelloCFD=\"HA9AAQQHSlQjM1F6Okx/I1e9DrUcToeYc//TcZZAPCiPwdA+wwDvyJmWm2RFS/uwurtG4ilzw9Nc9WX2k+iQF342G4NGGzkNGCsJI5oheS0+KelZfmtnSov1wcrWYfZ54LiacRUDgxl7iXC6yQjd6QfPtjeIibhZ8fuEq/tPuq9FeicrWi4EBXCtSx8KD5tWNSgkkQceRATy26UaIOXG9IlVBrVsRqA9rP2SA+SlbgFKS5WYpC9zXqFzAVv82+pKh9C9/t6DU6QMZL0VRglyniwzSKgbzUz3JCCIsDlTmoKNCrjXzhpLaZ5XCdYDrOFK1RAJe1eCLfz6Aib1mwNQxg==\" NoCertificadoSAT=\"30001000000400002495\" SelloSAT=\"pZxFogKsAfxT8v1M53OyARpEO2hvWNE2FmTDN7/X8LjSf7ZXwI0PGhYnKlevEgvUvv/i9Uog6lKbaenPPKx6H5AIwmLWgwMLeJ6Fyxbz5/aMWB82n1Uzfmofs3NQfDCZRfRfd3TA55s+MQiS60XNA3bBFObQcjbl1g8l8DjIZPO9hRXCuj54fwFYWLM/JRqRdfBKv+BFd/s9DaF4EHTpI5IrFpFRlXoWoob1itsKTC3Bdi3d0CFXPERxjc6ad8gaF2X9czAX6G05MS5435pdXOWpLO+TKIFIB3D+XYBY6iL3Bp4BTriKR/g3XeYTu/Pp6KV8Rk9DtDcgGgPHY+M1Jg==\" xmlns:tfd=\"http://www.sat.gob.mx/TimbreFiscalDigital\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" /></cfdi:Complemento></cfdi:Comprobante>"
    },
    "status": "success"
}
{
    "message": "Xml CFDI33 no proporcionado o viene vacio.",
    "messageDetail": null,
    "data": null,
    "status": "error"
}
AtributoTipoDescripción
messageStringCódigo regresado cuando existe un error.
messageDetailStringMensaje más descriptivo del error cuando existe uno.
dataobject/nullObjeto de datos referente al timbrado cuando es exitoso. Los parámetros varían según la versión de respuesta.
statusString“success” o “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 agosto 5, 2025

Related Articles