DOCUMENTACION API COMERCIAL

Guías para facturar desde tu sistema o aplicación

GUIA DE INICIO RAPIDO

Paso 4: Prueba tu Conexión

Una vez que tu cuenta esté configurada y tengas tus credenciales, puedes realizar tu primera prueba de conexión a la API de Enlace Fiscal. Este paso te permite verificar que la conexión con Enlace Fiscal es exitosa y que tus datos de autenticación están correctos.
Nuestra API de tipo RESTful usa autenticación con el estándar Basic Auth a través de encabezados de HTTP. Tanto petición como respuesta utilizan datos planos en formato JSON. Para obtener más información sobre la autenticación de las peticiones, consulta la sección de Autenticación.

Para realizar una prueba de conexión, puedes elegir entre las siguientes herramientas:

Para realizar la petición con cURL

Necesitas tener cURL instalado en tu computadora.
  1. Copia el siguiente ejemplo de petición de conexió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"} }'
  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 <RFC> con el RFC de la cuenta que consume la API.
  3. Pega la petición dentro de tu línea de comando.

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

Necesitas tener la aplicación de Postman instalada en tu computadora.
  1. Descarga la colección de Postman de Enlace Fiscal.
  2. Abre la aplicación de Postman.
  3. En Postman, ve a File > Import.
  4. En Upload File, selecciona la colección de Postman descargada en el paso 1.
    Se abre la colección PeticionesEF con varios endpoints de la API de Enlace Fiscal. Cada endpoint de la API tiene sus parámetros preconfigurados.
  5. En el menú de la izquierda de la colección PeticionesEF, selecciona POST ProbarConexion.
  6. En la pestaña Autorization, selecciona Basic Auth en el menú Type.
  7. Pon tus datos de Usuario en Username y tu Clave de Autorización (Token) en Password.
  8. En la pestaña Header, pon tu API Key como valor del parámetro x-api-key.
  9. En la pestaña Body, asegúrate de que el parámetro modo tenga como valor debug, y pon el RFC de la cuenta que consume la API como valor en el parámetro rfc.
  10. Haz clic sobre Send.

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 probarConexion en formato JSON:

 {
	"AckEnlaceFiscal": {
		"numeroReferencia": 1,
		"estatusDocumento": "aceptado",
		"fechaMensaje": "2017-08-25 23:04:40",
		"version": "1.0"
	}
}

La etiqueta "estatusDocumento": "aceptado" muestra que la conexión con la API de Enlace Fiscal es exitosa y que tus datos de autenticación están correctos. En caso de que la respuesta regrese "estatusDocumento": "rechazado", verifica que has ingresado correctamente tus datos de autenticación en la petición.

¿Tienes preguntas?

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