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

Actualizar empresa

A continuación se explica como actualizar los datos de una empresa dada de alta en Factura.com

Suggest Edits

Para actualizar la información de una empresa es necesario enviar los siguientes parámetros:

Parámetro
Tipo
Requerido

razons

string

Requerido

Indica la Razón social de la empresa.

rfc

string

Requerido

Indica el RFC de la empresa con min:12 y max:13 caracteres.

regimen

string

Opcional

Indica el código del régimen fiscal al que pertenece tu empresa

Consulta las claves de Régimen fiscal válidas.

calle

string

Requerido

Indica el domicilio fiscal.

numero_exterior

int

Requerido

Indica el número exterior.

numero_interior

int

Opcional

Indica el número interior.

codpos

numeric

Requerido

Indica el código postal.
Éste debe ser de 5 caracteres.

colonia

string

Requerido

Indica la colonia.

estado

string

Requerido

Indica el estado.

ciudad

string

Requerido

Indica la ciudad.

delegacion

string

Opcional

Indica la delegación en caso de contar con ella.

email

string

Requerido

Indica el Email.

Construcción de la URL

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

Ejemplo: https://factura.com/api/v1/account/client_uid/update

Ejemplo:

<?php
$ch = curl_init();

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

curl_setopt($ch, CURLOPT_POST, TRUE);

curl_setopt($ch, CURLOPT_POSTFIELDS, "{
  \"razons\": \"Ferreteria Perez\",
  \"rfc\": \"XAXX010101000\",
  \"regimen\": \"611\",
  \"calle\": \"Av. Juarez\",
  \"numero_exterior\": 1234,
  \"numero_interior\": \"4\",
  \"codpos\": 44640,
  \"colonia\": \"Centro\",
  \"estado\": \"Jalisco\",
  \"ciudad\": \"Guadalajara\",
  \"delegaion\": \"\",
  \"email\": \"josepe@email.com\"
}");

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.

Además reemplazar el client_uid en la URL.

Respuesta:

[
    {
        "status": "success",
        "data": {
                    "uid": "5670a524cfc65",
                    "razon_social": "EMPRESA DEMOSTRACION",
                    "rfc": "XAXX010101000",
                    "regimen_fiscal": "611",
                    "calle": "Av. Ficticia",
                    "exterior": "4587",
                    "interior": 7,
                    "colonia": "Centro",
                    "codpos": "44987",
                    "ciudad": "Guadalajara",
                    "estado": "Jalisco",
                    "email": "email@tucorreo.com",
                }
    }
]
 
{
  "status": "error",
  "message": "La cuenta que intenta autenticarse no existe",
  "Data": "$2y$10$dnOV7qC7ZrD1CZitpUnTReLKtKPxG29XfwZylrEuiR0KVl18pOXXX",
  "Secret": "$2y$10$6ZN4aX5UExwz6HFlDSZcxOF1TGjHx8f40neE.CrXHHahyAfi8XXX."
}

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.