Consumir servicio de timbrado API Opravy

Modificado el Tue, 05 Sep 2023 a las 05:51 PM

Dirección de la api: https://timbradoopravytest.azurewebsites.net/

Dirección pruebas: https://timbradoopravytest.azurewebsites.net/swagger/index.html

Dirección esquema: https://timbradoopravytest.azurewebsites.net/swagger/v1/swagger.json

Catálogos del SAT: http://omawww.sat.gob.mx/tramitesyservicios/Paginas/documentos/catCFDI_V_4_04092023.xls

Ejercicio de uso.

Ingresa a la direccion: https://timbradoopravytest.azurewebsites.net/swagger/index.html
Obtener un token con tu usuario y contraseña de cuenta, se utiliza autenticacion "Bearer" (El token caduca cada 78 hrs)
- ```
{
  "usuario": "prueba",
  "contrasena": "123456",
  "numeroLicencia": ""
}
```
Copia el token que se genera sin las comillas inicial y final
Pega el token en la sección superior, busca el botón "Authorize"

Una vez autenticado podrás cargar los datos de la empresa que emitirá las facturas (para tus pruebas podrás usar el idSucursal "000001" que ya se encuentra registrado en la lista), indicar "true" en el parámetro "registrosNuevos" cuando estés agregando una sucursal para generar facturar y "false" cuando necesites editar alguna existente

Solo los datos que se muestran llenos en el ejemplo son los que importan
El Id no se debe repetir en la lista de sucursales
ArchivoKey debe estar codificado en Base64 (.key de los Sellos Digitales)
ArchivoCer debe estar codificado en Base64 (.cer de los Sellos Digitales)
ContrasenaCertificado debes encriptarla con el Api Point "encripta_aes" disponible en esta pagina tambien
Estatus 1 (significa activo)

[
  {
    "id": "000002",
    "nombreComercial": "EMPRESA DE PRUEBA 2",
    "nombreSucursal": "PRUEBA2",
    "telefono": "",
    "celular": "",
    "correo": "usuario@mail.com",
    "versionContratada": "",
    "zonaHoraria": 0,
    "rfc": "XAXX010101000",
    "razonSocial": "EMPRESA DE PRUEBA 2 SA DE CV",
    "regimenFiscal": "",
    "calle": "",
    "numeroExterior": "",
    "numeroInterior": "",
    "codigoPostal": "",
    "referencia": "",
    "colonia": "",
    "municipio": "",
    "localidad": "",
    "entidadFederativa": "",
    "pais": "",
    "archivoKey": "MIIFDjBABgkqhkiG9w0BBQ0wMzAbBgkqhkiG9w0BBQwwDgQIAgEAAoIBAQACAggAMBQGCCqGSIb3DQMHBAgwggS/AgEAMASCBMh4EHl7aNSCaMDA1VlRoXCZ5UUmqErAbucoZQObOaLUEm+I+QZ7Y8Giupo+F1XWkLvAsdk/uZlJcTfKLJyJbJwsQYbSpLOCLataZ4O5MVnnmMbfG//NKJn9kSMvJQZhSwAwoGLYDm1ESGezrvZabgFJnoQv8Si1nAhVGTk9FkFBesxRzq07dmZYwFCnFSX4xt2fDHs1PMpQbeq83aL/PzLCce3kxbYSB5kQlzGtUYayiYXcu0cVRu228VwBLCD+2wTDDoCmRXtPesgrLKUR4WWWb5N2AqAU1mNDC+UEYsENAerOFXWnmwrcTAu5qyZ7GsBMTpipW4Dbou2yqQ0lpA/aB06n1kz1aL6mNqGPaJ+OqoFuc8Ugdhadd+MmjHfFzoI20SZ3b2geCsUMNCsAd6oXMsZdWm8lzjqCGWHFeol0ik/xHMQvuQkkeCsQ28PBxdnUgf7ZGer+TN+2ZLd2kvTBOk6pIVgy5yC6cZ+o1Tloql9hYGa6rT3xcMbXlW+9e5jM2MWXZliVW3ZhaPjptJFDbIfWxJPjz4QvKyJk0zok4muv13Iiwj2bCyefUTRz6psqI4cGaYm9JpscKO2RCJN8UluYGbbWmYQU+Int6LtZj/lv8p6xnVjWxYI+rBPdtkpfFYRp+MJiXjgPw5B6UGuoruv7+vHjOLHOotRo+RdjZt7NqL9dAJnl1Qb2jfW6+d7NYQSI/bAwxO0sk4taQIT6Gsu/8kfZOPC2xk9rphGqCSS/4q3Os0MMjA1bcJLyoWLp13pqhK6bmiiHw0BBXH4fbEp4xjSbpPx4tHXzbdn8oDsHKZkWh3pPC2J/nVl0k/yF1KDVowVtMDXE47k6TGVcBoqe8PDXCG9+vjRpzIidqNo5qebaUZu6riWMWzldz8x3Z/jLWXuDiM7/Yscn0Z2GIlfoeyz+GwP2eTdOw9EUedHjEQuJY32bq8LICimJ4Ht+zMJKUyhwVQyAER8byzQBwTYmYP5U0wdsyIFitphw+/IH8+v08Ia1iBLPQAeAvRfTTIFLCs8foyUrj5Zv2B/wTYIZy6ioUM+qADeXyo45uBLLqkN90Rf6kiTqDld78NxwsfyR5MxtJLVDFkmf2IMMJHTqSfhbi+7QJaC11OOUJTD0v9wo0X/oO5GvZhe0ZaGHnm9zqTopALuFEAxcaQlc4R81wjC4wrIrqWnbcl2dxiBtD73KW+wcC9ymsLf4I8BEmiN25lx/OUc1IHNyXZJYSFkEfaxCEZWKcnbiyf5sqFSSlEqZLc4lUPJFAoP6s1FHVcyO0odWqdadhRZLZC9RCzQgPlMRtji/OXy5phh7diOBZv5UYp5nb+MZ2NAB/eFXm2JLguxjvEstuvTDmZDUb6Uqv++RdhO5gvKf/AcwU38ifaHQ9uvRuDocYwVxZS2nr9rOwZ8nAh+P2o4e0tEXjxFKQGhxXYkn75H3hhfnFYjik/2qunHBBZfcdG148MaNP6DjX33M238T9Zw/GyGx00JMogr2pdP4JAErv9a5yt4YR41KGf8guSOUbOXVARw6+ybh7+meb7w4BeTlj3aZkv8tVGdfIt3lrwVnlbzhLjeQY6PplKp3/a5Kr5yM0T4wJoKQQ6v3vSNmrhpbuAtKxpMILe8CQoo=",
    "archivoCer": "MIIFsDCCA5igAwIBAgIUMzAwMDEwMDAwMDA1MDAwMDM0MTYwDQYJKoZIhvcNAQELBQAwggErMQ8wDQYDVQQDDAZBQyBVQVQxLjAsBgNVBAoMJVNFUlZJQ0lPIERFIEFETUlOSVNUUkFDSU9OIFRSSUJVVEFSSUExGjAYBgNVBAsMEVNBVC1JRVMgQXV0aG9yaXR5MSgwJgYJKoZIhvcNAQkBFhlvc2Nhci5tYXJ0aW5lekBzYXQuZ29iLm14MR0wGwYDVQQJDBQzcmEgY2VycmFkYSBkZSBjYWxpejEOMAwGA1UEEQwFMDYzNzAxCzAJBgNVBAYTAk1YMRkwFwYDVQQIDBBDSVVEQUQgREUgTUVYSUNPMREwDwYDVQQHDAhDT1lPQUNBTjERMA8GA1UELRMIMi41LjQuNDUxJTAjBgkqhkiG9w0BCQITFnJlc3BvbnNhYmxlOiBBQ0RNQS1TQVQwHhcNMjMwNTE4MTE0MzUxWhcNMjcwNTE4MTE0MzUxWjCB1zEnMCUGA1UEAxMeRVNDVUVMQSBLRU1QRVIgVVJHQVRFIFNBIERFIENWMScwJQYDVQQpEx5FU0NVRUxBIEtFTVBFUiBVUkdBVEUgU0EgREUgQ1YxJzAlBgNVBAoTHkVTQ1VFTEEgS0VNUEVSIFVSR0FURSBTQSBERSBDVjElMCMGA1UELRMcRUtVOTAwMzE3M0M5IC8gVkFEQTgwMDkyN0RKMzEeMBwGA1UEBRMVIC8gVkFEQTgwMDkyN0hTUlNSTDA1MRMwEQYDVQQLEwpTdWN1cnNhbCAxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtmecO6n2GS0zL025gbHGQVxznPDICoXzR2uUngz4DqxVUC/w9cE6FxSiXm2ap8Gcjg7wmcZfm85EBaxCx/0J2u5CqnhzIoGCdhBPuhWQnIh5TLgj/X6uNquwZkKChbNe9aeFirU/JbyN7Egia9oKH9KZUsodiM/pWAH00PCtoKJ9OBcSHMq8Rqa3KKoBcfkg1ZrgueffwRLws9yOcRWLb02sDOPzGIm/jEFicVYt2Hw1qdRE5xmTZ7AGG0UHs+unkGjpCVeJ+BEBn0JPLWVvDKHZAQMj6s5Bku35+d/MyATkpOPsGT/VTnsouxekDfikJD1f7A1ZpJbqDpkJnss3vQIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdDwQEAwIGwDANBgkqhkiG9w0BAQsFAAOCAgEAFaUgj5PqgvJigNMgtrdXZnbPfVBbukAbW4OGnUhNrA7SRAAfv2BSGk16PI0nBOr7qF2mItmBnjgEwk+DTv8Zr7w5qp7vleC6dIsZFNJoa6ZndrE/f7KO1CYruLXr5gwEkIyGfJ9NwyIagvHHMszzyHiSZIA850fWtbqtythpAliJ2jF35M5pNS+YTkRB+T6L/c6m00ymN3q9lT1rB03YywxrLreRSFZOSrbwWfg34EJbHfbFXpCSVYdJRfiVdvHnewN0r5fUlPtR9stQHyuqewzdkyb5jTTw02D2cUfL57vlPStBj7SEi3uOWvLrsiDnnCIxRMYJ2UA2ktDKHk+zWnsDmaeleSzonv2CHW42yXYPCvWi88oE1DJNYLNkIjua7MxAnkNZbScNw01A6zbLsZ3y8G6eEYnxSTRfwjd8EP4kdiHNJftm7Z4iRU7HOVh79/lRWB+gd171s3d/mI9kte3MRy6V8MMEMCAnMboGpaooYwgAmwclI2XZCczNWXfhaWe0ZS5PmytD/GDpXzkX0oEgY9K/uYo5V77NdZbGAjmyi8cE2B2ogvyaN2XfIInrZPgEffJ4AB7kFA2mwesdLOCh0BLD9itmCve3A1FGR4+stO2ANUoiI3w3Tv2yQSg4bjeDlJ08lXaaFCLW2peEXMXjQUk7fmpb5MNuOUTW6BE=",
    "contrasenaCertificado": "RZVBy5D1OAJR0xpLZgEBkg==",
    "logotipoFondo": "",
    "logotipoVentana": "",
    "logotipoImpresion": "",
    "logotipoNegro": "",
    "numeroLicencia": "",
    "estatus": 1,
    "terminalCreacion": "",
    "fechaCreacion": "2023-09-05T17:59:00.738Z",
    "usuarioCreacion": "",
    "fechaModificacion": "2023-09-05T17:59:00.738Z",
    "usuarioModificacion": "",
    "fechaActualizacion": "2023-09-05T17:59:00.738Z",
    "usuarioActualizacion": "",
    "fechaSincronizacion": "2023-09-05T17:59:00.738Z",
    "usuarioSincronizacion": ""
  }
]

Una vez cargados los datos de la empresa emisora con sus sellos digitales, podemos enviar la primera prueba de timbrado (necesitaras los catálogos del SAT, revisa el link de descarga en la parte superior)

Solo los datos que se muestran llenos en el ejemplo son los que importan
FormaPago se toma del catalogo SAT "c_FormaPago"
CodigoMoneda se toma del catalogo SAT "c_Moneda"
Municipio se toma del catalogo SAT "c_Municipio"
Localidad se toma del catalogo SAT "c_Localidad"
EntidadFederativa se toma del catalogo SAT "c_Estado"
Pais se toma del catalogo SAT "c_Pais"
TipoComprobante se toma se toma del catalogo SAT "c_TipoDeComprobante"
RegimenFiscalEmisor se toma del catalogo SAT "c_RegimenFiscal"
MetodoPago se toma del catalogo SAT "c_MetodoPago"
FormaPago se toma del catalogo SAT "c_FormaPago"
UsoCfdi se toma del catalogo SAT "c_UsoCFDI"
Periodicidad se usa en factura global
Meses se usa en factura global
Año se usa en factura global
ObjetoImpuesto se toma del catalogo SAT "c_ObjetoImp"
UnidadMedida se toma del catalogo SAT "c_ClaveUnidad"
ClaveProductosServicios se toma del catalogo SAT "c_ClaveProdServ"

{
   "documento":{
      "Folio":"PRUE000001",
      "FechaDocumento":"2023-09-05T00:00:00",
      "FormaPago":"01-Efectivo",
      "CodigoMoneda":"MXN",
      "TipoCambio":1.0,
      "CondicionPago":"30D",
      "NombreEmpresa":"PUBLICO EN GENERAL",
      "Calle":"",
      "NumeroExterior":"",
      "NumeroInterior":"",
      "CodigoPostal":"47600",
      "Referencia":"",
      "Colonia":"CENTRO",
      "Municipio":"093-Tepatitlan de Morelos",
      "Localidad":"08-Tepatitlan de Morelos",
      "EntidadFederativa":"JAL-Jalisco",
      "Pais":"MEX-México",
      "Importe":45.34,
      "Descuento":0.0,
      "SubTotal":45.34,
      "BaseIeps":0.0,
      "Ieps":0.0,
      "BaseIsr":0.0,
      "Isr":0.0,
      "BaseIva":45.34,
      "Iva":4.97,
      "IepsRetenido":0.0,
      "IvaRetenido":0.0,
      "Total":50.31
   },
   "documentoCfdi":{
      "TipoComprobante":"I",
      "RfcEmisor":"EKU9003173C9",
      "RazonSocialEmisor":"ESCUELA KEMPER URGATE",
      "RegimenFiscalEmisor":"626-Regimen simplificado de confianza",
      "CodigoPostalEmisor":"",
      "Rfc":"XAXX010101000",
      "RazonSocial":"EMPRESA DE PRUEBA TIMBRADO",
      "RegimenFiscal":"616-Sin obligaciones fiscales",
      "MetodoPago":"PUE-Pago en una sola exhibición",
      "FormaPago":"01-Efectivo",
      "UsoCfdi":"S01-Sin efectos fiscales",
      "CuentaBancaria":"",
      "CodigoBanco":"",
      "IdTributario":"",
      "CodigoAddenda":"",
      "Periodicidad":"",
      "Meses":"",
      "Año":"",
      "NombreComplemento":"",
      "XmlComplemento":"",
      "XmlDocumentosRelacionados":""
   },
   "desglose":[
      {
         "Descripcion":"PLATO TRINCHE ANTARTIC",
         "Cantidad":1.0,
         "PrecioUnitario":31.04,
         "DescuentoUnitario":0.0,
         "ValorIeps":0.0,
         "ValorIsr":0.0,
         "ValorIva":16.0,
         "ValorIepsRetenido":0.0,
         "ValorIvaRetenido":0.0,
         "Importe":31.04,
         "Descuento":0.0,
         "SubTotal":31.04,
         "BaseIeps":0.0,
         "Ieps":0.0,
         "BaseIsr":0.0,
         "Isr":0.0,
         "BaseIva":31.04,
         "Iva":4.97,
         "IepsRetenido":0.0,
         "IvaRetenido":0.0,
         "Total":36.01,
         "ObjetoImpuesto":"02-Si objeto de impuesto",
         "UnidadMedida":"H87",
         "ClaveProductosServicios":"52152000"
      },
      {
         "Descripcion":"BEBIDA ARTESANAL TE DE JAMAICA",
         "Cantidad":1.0,
         "PrecioUnitario":14.3,
         "DescuentoUnitario":0.0,
         "ValorIeps":0.0,
         "ValorIsr":0.0,
         "ValorIva":0.0,
         "ValorIepsRetenido":0.0,
         "ValorIvaRetenido":0.0,
         "Importe":14.3,
         "Descuento":0.0,
         "SubTotal":14.3,
         "BaseIeps":0.0,
         "Ieps":0.0,
         "BaseIsr":0.0,
         "Isr":0.0,
         "BaseIva":14.3,
         "Iva":0.0,
         "IepsRetenido":0.0,
         "IvaRetenido":0.0,
         "Total":14.3,
         "ObjetoImpuesto":"02-Si objeto de impuesto",
         "UnidadMedida":"H87",
         "ClaveProductosServicios":"01010101"
      }
   ]
}

Para cancelar un CFDI se indica el UUID del Cfdi y alguno de los siguientes motivos de cancelacion:
- 01-Comprobantes emitidos con errores con relación
- 02-Comprobantes emitidos con errores sin relación
- 03-No se llevó a cabo la operación
- 04-Operación nominativa relacionada en una factura global