DOCUMENTACION API COMERCIAL

Guías para facturar desde tu sistema o aplicación
  1. Inicio
  2. Documentación
  3. Autenticación

AUTENTICACION

La autenticación se hace con el estándar Basic Auth. Cada cuenta ligada a una persona física o moral tiene un usuario de API, un token o clave de autorización y un x-api-key. Si no se incorporan las credenciales en la petición, la API regresa una respuesta de error describiendo el elemento faltante.

Las credenciales de cada cuenta son idénticas en los entornos de prueba y de producción.

Recomendamos que mantengas las credenciales de tu cuenta en un lugar seguro.

Para obtener tus credenciales

Necesitas crear una cuenta y activar la modalidad de la API en tu cuenta para obtener tus credenciales y consumir la API.

Una vez que tengas tu cuenta activada, puedes consultar tus credenciales en todo momento en el portal de Enlace Fiscal en la sección de CFDis Comerciales/API.

Para utilizar tus credenciales

Cada petición debe ser enviada con los siguientes datos de autenticación en los encabezados HTTP:

  • <USUARIO> de la API Ej. AAA010101AAA
  • <TOKEN> Ej. 8bb16d2e055554fcf3d182758db23c91
  • <X-API-KEY> Ej. 7aa16d2e055554fcf3d182758db23c91

La API de Enlace Fiscal utiliza el parámetro <RFC> como elemento adicional de autenticación dentro del cuerpo de la petición. El RFC proporcionado en la petición debe de coincidir con el usuario y consta de 12 carácteres para persona moral y 13 carácteres para persona física.

Las peticiones deben realizarse via el protocolo seguro HTTPS.

En el siguiente código se resalta cómo se deben utilizar los datos de autenticación al hacer una petición:


	curl "https://api.enlacefiscal.com/v6/probarConexion"
	--request "POST"
	--header "Content-Type:application/json"
	--header "x-api-key:<X-API-KEY>"
	--user "<USUARIO>:<TOKEN>"
	--data '{"Solicitud" : { "rfc" : "<RFC>", "accion": "probarConexion" } }'

Mensajes de error

A continuación se describen algunos mensajes de error relacionados a una autenticación inválida.

Código de error Descripción de error Solución
800 Usuario o Contraseña no válido En el encabezado de la petición, verifica que has ingresado correctamente el usuario y la contraseña de la cuenta.
801 El RFC proporcionado en la petición no coincide con su usuario En el cuerpo de la petición, verifica que el parámetro rfc sea el mismo que el RFC de la cuenta que está consumiendo la API. No debe contener guiones ni espacios.
811 El campo solicitud.rfc debe de contener al menos 12 caracteres En el cuerpo de la petición, verifica que el parámetro rfc tenga la longitud correcta: 12 carácteres para Persona Moral; 13 carácteres para Persona Física.
--- Forbidden En el encabezado de la petición, verifica que has ingresado correctamente el valor del x-api-key de la cuenta.

¿Tienes preguntas?

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