Factura.com

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

Consultar RFC repetido con diferente información

A continuación se explica como consultar un RFC dado de alta más de una vez pero con distintas razones sociales o distintos datos.

Suggest Edits

Para consultar un RFC en específico es necesario enviarlo en la petición.

Parámetro
Tipo
Requerido
Detalles

rfc

string

Opcional

*Requerido en el caso de querer consultar solo a un cliente.

Indica el RFC a buscar, para traer toda la información de los clientes registrados con el mismo.

Construcción de la URL

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

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

Ejemplo:

<?php
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://factura.com/api/v1/clients/rfc/XAXX010101000");
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);
 
curl -i -H "Content-Type: application/json" -H "F-API-KEY: tu key" -H "F-SECRET-KEY: tu secret key" https://factura.com/api/v1/clients/rfc/XAXX010101000

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.

Además de reemplazar el_rfc por el RFC que deseas consultar.

Importante

En caso de tener más de un cliente registrado con el mismo RFC, la respuesta a esta petición incluirá a todos los clientes dados de alta cuyo RFC coincida con el solicitado, de este modo podrás elegir de entre los resultados el cliente que requieres.

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."
    },
    {
                "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."
    },
    {
                "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.

Updated 4 months ago

Consultar RFC repetido con diferente información

A continuación se explica como consultar un RFC dado de alta más de una vez pero con distintas razones sociales o distintos datos.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.