Factura.com API

La documentación de la API de Factura.com ofrece una descripción de los métodos y endpoints disponibles, ejemplos de las posibles respuestas obtenidas e información general para facilitar el uso de nuestra API.

Documentación

Listar clientes

A continuación se explica como listar los clientes , con un ejemplo y muestra de posibles respuestas obtenidas.

Podemos listar todos los clientes que tenemos registrados en el sistema.

Construcción de la URL

Host: https://factura.com (producción) / http://devfactura.in (sandbox)
Endpoint: /api/v1/clients

Ejemplo: https://factura.com/api/v1/clients

Ejemplo:

<?php
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://factura.com/api/v1/clients");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_HEADER, FALSE);

curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "Content-Type: application/json",
    "F-PLUGIN: " . '9d4095c8f7ed5785cb14c0e3b033eeb8252416ed',
    "F-Api-Key: ".'Ingresa API KEY',
    "F-Secret-Key: " .'Ingresa SECRET KEY'
));
$response = curl_exec($ch);
curl_close($ch);

var_dump($response);

Recuerda

Para probar el código de ejemplo es necesario que reemplaces el texto Ingresa API KEY por el API KEY de tu cuenta, e Ingresa SECRET KEY por el SECRET KEY correspondiente.

Respuesta:

[
    {
        "status": "success o error",
        "data": [
            {
                "RazonSocial" : "Razón Social del cliente",
                "RFC" : "Registro Federal de Contribuyentes del cliente",
                "Calle" : "Calle del domicilio del cliente",
                "Numero" : "Número exterior del domicilio del cliente",
                "Interior" : "Número interior del domicilio del cliente",
                "Colonia" : "Colonia de domicilio del cliente", 
                "CodigoPosal" : "Código Postal del domicilio del cliente",
                "Ciudad" : "Ciudad del domicilio del cliente",
                "Delegacion" : "Delegación del domicilio del cliente",
                "Estado" : "Estado del domicilio del cliente",
                "NumRegIdTrib" : "",
                "UsoCFDI" : "",
                "Contacto"[{
                    "Nombre":"Nombre(s) del cliente",
                    "Apellidos":"Apellidos del cliente",
                    "Email":"Correo electrónico del cliente",
                    "Email2":"Correo electrónico 2 del cliente",
                    "Email3":"Correo electrónico 3 del cliente",
                    "Telefono":"Número de teléfono del cliente"
                }]
                                }                ],
        "UID": "Id único e irrepetible asignado por Factura.com y que servirá para la gestión interna del docmento."
    }
]

Sobre errores

El mensaje de error puede variar dependiendo el nodo en el que haya información incorrecta.

Te sugerimos leer cuidadosamente el mensaje del error ya que en el mismo se indica donde es necesario corregir la información.