DOCUMENTACION API COMERCIAL

Guías para facturar desde tu sistema o aplicación
  1. Inicio
  2. Documentación
  3. Guía de Inicio Rápido
  4. Emite una Factura de Prueba

GUIA DE INICIO RAPIDO

Paso 5: Emite una Factura de Prueba

Una vez que hayas comprobado que la conexión a la API de Enlace Fiscal es exitosa, puedes generar tu primera factura de prueba. Utiliza el entorno de pruebas de nuestra API para hacer todas las pruebas que necesites gratis antes de emitir un comprobante fiscalmente válido.
Los comprobantes que se generan en el entorno de pruebas no tienen valor fiscal. Este paso te permite verificar que todos los demás elementos del comprobante sean correctos, tal como trabajarías en producción. Por ejemplo, puedes revisar el diseño del comprobante, la configuración de los impuestos y descargar los archivos PDF y XML de la factura de prueba.

A partir del 1 de enero de 2022 entra en vigor la versión 4.0 del CFDI, existiendo un periodo de convivencia entre la versión 3.3 y la versión 4.0 el cual comprende del 1 de enero al 30 de abril de 2022. Enlace Fiscal está trabajando para actualizar la API Comercial y minimizar el impacto de estos cambios en tu sistema.

Para generar una factura de prueba, puedes elegir entre las siguientes herramientas:

Para realizar la petición con cURL

  1. Copia el siguiente ejemplo de petición para generar una factura con IVA 16% en formato JSON: 
    
curl "https://api.enlacefiscal.com/v6/generarCfdi"
--request "POST"
--header "Content-Type:application/json"
--header "x-api-key:<X-API-KEY>"
--user "<USUARIO>:<TOKEN>"
--data '{
	"CFDi": {
		"modo": "debug",
		"versionEF": "6.0",
		"serie": "<SERIE>",
		"folioInterno": "1",
		"fechaEmision": "<FECHA-EMISION>",
		"subTotal": "20.00",
		"total": "23.20",
		"rfc": "<RFC>",
		"DatosDePago": {
			"formaDePago": "03"
	},
	"Receptor": {
		"rfc": "XAXX010101000",
		"nombre": "Empresa Demo's",
		"usoCfdi": "adquisicion_mercancias"
	},
	"Partidas": [
	{
		"cantidad": "1",
		"claveUnidad": "KGM",
		"claveProdServ": "42171606",
		"descripcion": "1 Kg de arroz",
		"valorUnitario": "20.00",
		"importe": "20.00",
		"Impuestos": [
		{
			"tipo": "traslado",
			"claveImpuesto": "IVA",
			"tipoFactor": "tasa",
			"tasaOCuota": "0.16",
			"baseImpuesto": "20.00",
			"importe": "3.20"
				}
			]
		}
	],
	"Impuestos": {
		"Totales": {
			"traslados": "3.20"
		},
		"Impuestos": [
			{
			"tipo": "traslado",
			"claveImpuesto": "IVA",
			"tipoFactor": "tasa",
			"tasaOCuota": "0.16",
			"importe": "3.20"
			}
		]
	}
}
}
  2. Reemplaza los siguientes elementos:
    • En el encabezado de tu petición, reemplaza <X-API-KEY> con tu API Key.
    • En user, reemplaza <USUARIO> y <<TOKEN> con tus credenciales.
    • En el cuerpo de tu petición, reemplaza lo siguiente:
      • <RFC> con el RFC de la cuenta que consume la API.
      • <SERIE> con el Nombre de Serie configurado en el portal de Enlace Fiscal en el Segundo Paso de esta guía.
      • <FECHA-EMISION> con la fecha y horario actuales, en formato AAAA-MM-DD hh:mm:ss. Por ejemplo: 2021-11-02 09:33:00.
        La fecha de emisión no puede ser a futuro y tiene que estar dentro de las 72 horas anteriores a la petición.
  3. Pega la petición dentro de tu línea de comando.

Te recomendamos que cambies el valor de folioInterno para cada factura que generes. El folio interno junto con la serie asignada se utilizan como método de control interno para evitar timbrar un mismo comprobante más de una vez. Si por error se llega a enviar la petición de timbrado de un mismo folio y serie en varias ocasiones, la API de Enlace Fiscal no la timbra otra vez, simplemente envía la información del timbrado original.

Para obtener información detallada de cada parámetro de la petición, consulta la Referencia de la API.

Para realizar la petición con Postman

  1. Abre la colección PeticionesEF previamente descargada en Postman.
  2. En el menú de la izquierda de la colección PeticionesEF, selecciona POST GenerarCfdi.
  3. En la pestaña Header, pon tu API Key como valor de x-api-key.
  4. En la pestaña Body, asegúrate de que el parámetro modo tenga como valor debug y completa el valor de los siguientes parámetros:
    • rfc con el RFC de la cuenta que consume la API.
    • serie con el Nombre de Serie configurado en el portal de Enlace Fiscal en el Segundo Paso de esta guía.
    • fechaEmision con la fecha y horario actuales, en formato AAAA-MM-DD hh:mm:ss. Por ejemplo: 2021-11-02 09:33:00.
      La fecha de emisión no puede ser a futuro y tiene que estar dentro de las 72 horas anteriores a la petición.
  5. Haz clic sobre Send.

Te recomendamos que cambies el valor de folioInterno para cada factura que generes. El folio interno junto con la serie asignada se utilizan como método de control interno para evitar timbrar un mismo comprobante más de una vez. Si por error se llega a enviar la petición de timbrado de un mismo folio y serie en varias ocasiones, la API de Enlace Fiscal no la timbra otra vez, simplemente envía la información del timbrado original.

Para obtener información detallada de cada parámetro de la petición, consulta la Referencia de la API.

Respuesta

A continuación se muestra un ejemplo de respuesta exitosa a la petición POST generarCfdi:


		{
		"AckEnlaceFiscal": {
			"numeroReferencia": "123",
			"estatusDocumento": "aceptado",
			"fechaMensaje": "2017-07-20 11:22:02",
			"version": "1.0",
			"folioInterno": "1",
			"folioFiscalUUID": "4E80053F-74B9-4004-B7B6-09B30781B4F6",
			"serie": "FA",
			"noSerieCertificado": "20001000000200001111",
			"noSerieCertificadoSAT": "20001000000100001111",
			"selloCFDi": "...",
			"selloSAT": "...",
			"cadenaTFD": "...",
			"fechaGeneracionCFDi": "2017-03-27 17:03:09",
			"fechaTFD": "2017-03-27T18:55:05",
			"estadoCFDi": "vigente",
			"descargaArchivoQR": "https://descarga.enlacefiscal.com/QR/?i=QUFBMDEwMTAxQUFBLS0yMDE3XzE4XzRldsTNmLTc0YjktNDAwNC1iN2I2LTA5YjMwNzgxYjRmNi0tMS0tMTg=&b=0",
			"descargaArchivoPDF": "https://descarga.enlacefiscal.com/PDF/?i=YjMwNzgxYjRmNi0tMS0tMTg=&b=0",
			"xmlCFDi": "...",
			"descargaXmlCFDi": "https://descarga.enlacefiscal.com/CFDI/?i=QUFBMDEwMTAxQUFBLS0yMDE3XzE4XzRlODAwNTNmLTc0dssjktNDAwNC1iN2I2LTA5YjMwNzgxYjRmNi0tMS0tMTg=&b=0"
		}
	}

Dentro de la respuesta encontrarás todos los datos requeridos por el SAT. Además, encontrarás las siguientes URL para descargar los archivos XML, PDF y QR de tus comprobantes:

  • descargaXmlCFDi: URL para descargar tu factura en formato XML.
  • descargaArchivoPDF: URL para descargar tu factura en formato PDF.
    Los PDF de las facturas generadas en el modo de prueba contienen una marca de agua especificando que no tienen validez fiscal.
    El archivo PDF generado por la API puede ser personalizado en el portal de Enlace Fiscal con el logotipo y los colores de tu marca. Para personalizar tu PDF, consulta el artículo sobre la Edición de Diseño de PDF.
  • descargaArchivoQR: URL para descargar el archivo QR de tu factura.
    El archivo QR te proporciona todos las datos requeridos por el SAT en caso de que desees hacer tu propio diseño de comprobantes en formato PDF.

Para obtener información detallada de cada elemento de la respuesta, consulta el tutorial de Timbrar una factura.

Próximos pasos

Ahora que has realizado con éxito una solicitud y generado tu primera factura de prueba, puedes probar otras funcionalidades de la API de Facturación de Enlace Fiscal. Listamos algunos ejemplos a continuación:

Con la cuenta gratis de 30 días puedes emitir hasta 5 facturas con validez fiscal. Una vez que realizaste todas tus pruebas y funcionan como lo deseas, solo necesitas poner saldo a tu cuenta para seguir emitiendo comprobantes fiscalmente válidos. En efecto, Enlace Fiscal funciona con un sistema de prepago. Para poder emitir comprobantes en modo de producción, necesitas poner saldo a tu cuenta. El artículo de Aviso de Pago te proporciona las instrucciones para poner saldo a tu cuenta.

Para obtener más información sobre todos los endpoints y parámetros de la API, consulta la Referencia de la API.

¿Tienes preguntas?

Consulta nuestros artículos con preguntas frecuentes sobre facturación electrónica o contáctanos por correo.