API Asincrona

Generación de CFDI Async

URL	/<keyEmpresa>/cfdisAsync
Parámetros requeridos	idTipoCfd (Encriptado) idSucursal (Encriptado) archivoFuente (El parámetro es el texto contenido del archivo fuente) de acuerdo al conector/adaptador configurado
Parámetros/filtros opcionales	N/A
Método http	PUT
Notas	De existir un problema en el proceso del CFDI se regresan los errores de generación que se tuvieron. ES IMPORTANTE MENCIONAR que el contenido del documento a emitir se colocar en el Request Payload en estructura JSON En los headers se debe poner: "Content-Type: application/json" Se debe incluir el salto de línea entre registros utilizando “\n” Ejemplo: \|00\|idcfd\|FAC\|\n
Códigos respuesta/errores	200 - Ok 400 - Bad Request - Parámetros incorrectos 401 - Not Found - No existe la keyEmpresa
Ejemplo	https://localhost:9050/985408d8-64ae-48e0-b46c-473b47176205/cfdisAsync {"idTipoCfd":"d18bb0158356449c31e72cb69e642b31","idSucursal":"6ac9a2c315480d5cc5534c7e58caee5a","archivoFuente":"\|00\|idcfd\| FAC\|\n01\|1\|\|\|20140630T00:00:00\|99.09\|9999.09\|\|\|9999.009\|\|Noventa y nueve billones novecientos noventa y nueve mil novecientos noventa y nueve millones novecientos noventa y nueve mil novecientos noventa y nueve 90\/10000000\|USD\|12.5014\|REFERENCIA XXXAAAXXX\|Primera Observación\|Segunda Observación\|Tercera Observación\|\n02\|PAGO EN UNA SOLA EXHIBICIÓN\|10% DE INTERÉS SI NO SE PAGA ANTES DEL 05-AGOSTO-2010\|CHEQUE\|2010-08-05\|EFECTOS FISCALES AL PAGO\|\n03\|01\|AAA010101AAA\|PATITO, S.A. DE C.V.\|MÉXICO\|AVENIDA CALLE \|S\/N\|INT. 1\|COL. COLONIA\|MÉXICO\|REFERENCIA FRENTE AL OXXO\|CUAJIMALPA\|ESTADO DE MÉXICO\|06860\|4424876399\|\n05\|405010\|802011\|3\|BOMBA MOLOTOV\|150.00\|450.00\|PZA\|Categoría 5e\|205010\|\n05\|405011\|802012\|1\|DISFRAZ DE CORRECAMINOS\|2368231872779.000009\|884346835174.000009\|PZA\|Categoría 5e\|205011\|\n05\|405012\|802013\|10\|COMIDA DE CORRECAMINOS\|39.00\|390.00\|KG\|Categoría 5e\|205010\|\n05\|405013\|802014\|1\|LIGA DE HULE GIGANTE\|378.00\|378.00\|PZA\|Categoría 5e\|205011\|\n06\|IVA\|16.00\|9.09\|\n07\|IVA\|58.58\|\n06\|IVA\|16.00\|999999.09\|\n07\|IVA\|58.58\|\n08\|405010\|APTO INTL DE CIUDAD DE MEXICO\|2010-06-29\|548984124578124\|\|\n08\|405011\|APTO INTL DE CIUDAD DE MEXICO\|2010-06-29\|654651456987452\|\|\n99\|15\|\|"}
Ejemplo respuesta (código 200)	{ "idPeticion": "5503643c66ee9496d7223ad9f61e6609" }
Nota	La información de este API solo esta vigente por 30 días.

Consulta de CFDI Async

URL	/<keyEmpresa>/cfdis/{idPeticion}
Parámetros requeridos	N/A
Método http	GET
Notas	De existir un problema en el proceso del CFDI se regresan los errores de generación que se tuvieron. ES IMPORTANTE MENCIONAR que el contenido del documento a emitir se colocar en el Request Payload en estructura JSON En los headers se debe poner: "Content-Type: application/json" Se debe incluir el salto de línea entre registros utilizando “\n” Ejemplo: \|00\|idcfd\|FAC\|\n
Códigos respuesta/errores	200 - Ok 202 - Operación en proceso 400 - Bad Request - Documentos con errores de generación 404 - Documento no encontrado
Ejemplo	https://localhost:9050/985408d8-64ae-48e0-b46c-473b47176205/cfdis/5503643c66ee9496d7223ad9f61e6609
Ejemplo respuesta (código 200)	{ "uuid": "8B12F89B-12BF-4C3B-8AB0-4073EB2950D9", "fecha": "2023-07-20 10:25:41.0", "serie": "TWCP", "folio": "12", "rfc": "XAXX010101000", "iva": "", "monto": "0.000000", "descuento": "0.000000", "subtotal": "0.000000", "tipoCambio": "1.0000", "tipoMoneda": "MXN", "idCfd": "7d360d82703c3de6d3d72347a1bfe2d0", "idSucursal": "648cf7222d3968a23049d570252a1994", "status": "ALMACENADO", "produccion": true, "fechaCancelacion": "", "tienePDF": "true", "pedimento": "", "fechaPedimento": "", "aduana": "", "pdfAndXmlDownload": "/20c42654-8961-11ea-ab3d-fa163e0e7f24descargasCfdiAsync?idCfdi=7d360d82703c3de6d3d72347a1bfe2d0&produccion=true&representacion=XML_PDF", "pdfDownload": "/20c42654-8961-11ea-ab3d-fa163e0e7f24/descargasCfdiAsync?idCfdi=7d360d82703c3de6d3d72347a1bfe2d0&produccion=true&representacion=PDF", "xmlDownload": "/20c42654-8961-11ea-ab3d-fa163e0e7f24/descargasCfdiAsync?idCfdi=7d360d82703c3de6d3d72347a1bfe2d0&produccion=true&representacion=XML" }
Ejemplo respuesta (código 202)	Cuando esta en proceso de timbrado regresa el siguiente estatus: { "status": "EN_PROCESO" } Cuando ya se genero el CFDI pero está esperando a que se genere el PDF regresa el siguiente estatus: { "status": "EN_PROCESO", "uuid": "8B12F89B-12BF-4C3B-8AB0-4073EB2950D9" }
Ejemplo respuesta (código 400)	{ "errors": [ "Error CFDI40108\nEl TipoDeComprobante es I,E o N, el importe registrado en el campo no es igual al redondeo de la suma de los importes de los conceptos registrados.. :\n Código de error: CFDI40108" ] }
Ejemplo respuesta (código 404)	{ "status": "DOCUMENTO_NO_ENCONTRADO" }

Descarga del CFDI Async

URL	/<keyEmpresa>/descargasCfdiAsync
Parámetros requeridos	Al menos debe estar aplicado uno de los parámetros disponibles
Parámetros/filtros opcionales	uuid representacion: este puede ser XML o PDF o XML_PDF
Método http	GET
Códigos respuesta/errores	200 - Ok 204 - No Content - No existen CFDI 400 - Bad Request - Parámetros incorrectos 401 - Not Found - No existe la keyEmpresa \| No hay CFDIs para descargar
Ejemplo	Ejemplo #1 https://10.0.0.183:9050/985408d8-64ae-48e0-b46c-473b47176205/descargasCfdiAsync?representacion=XML Ejemplo #2 https://localhost:9050/985408d8-64ae-48e0-b46c-473b47176205/descargasCfdiAsync?uuid=9d8b7b0f-2aa6-47d7-8b45-d3abf26f57d1
Ejemplo respuesta (código 200)	Ejemplo #1 Se descarga el archivo de tipo XML Ejemplo #2 (Se descarga un documento de tipo ZIP, el cual contiene los archivos XML y PDF del CFDI correspondiente al UUID indicando en la URL)

No Comments

Back to top