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    

Crear producto

A continuación se explica como dar de alta un nuevo producto.

Podemos crear un nuevo producto haciendo uso de los siguientes parámetros:

Parámetro
Tipo
Requerido
Detalles

code

string

Opcional

Indica el código o SKU de tu producto.

name

string

Requerido

Indica el nombre de tu producto.

Éste nombre se mostrará en el apartado de Conceptos de tu CFDI.

price

numeric

Requerido

Indica el precio sin IVA de tu producto o servicio.

clavePS

string

Requerido

Indica la clave del producto o servicio correspondiente a tu concepto.

Consulta el catálogo de Clave Producto/Servicio .

unity

string

Requerido

Indica la unidad de medida, ésta debe corresponder a la clave indicada en el atributo claveUnity .

Consulta el catálogo de Clave Unidad .

claveUnity

string

Requerido

Indica la clave de la unidad de medida, ésta debe corresponder a la unidad indicada en el atributo unity .

Consulta el catálogo de Clave Unidad .

Construcción de la URL

Host: https://factura.com (producción) / http://devfactura.in (sandbox)
Endpoint: /api/v3/products/create

Ejemplo: https://factura.com/api/v3/products/create

Ejemplo:

<?php
$ch = curl_init();

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

curl_setopt($ch, CURLOPT_POST, TRUE);

curl_setopt($ch, CURLOPT_POSTFIELDS, "{
  \"code\": \"K001\",
  \"name\": \"Desarrollo de banner para publicidad\",
  \"price\": 35.9,
  \"clavePS\": \"1154544511\",
  \"unity\": \"Unidad de servicio\",
  \"claveUnity\": \"E48\"
}");

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",
    "data": [
      {
        "code": "Ferreteria Perez",
        "name": "XAXX010101000",
        "sku": "Av. Juarez",
        "price": "1234",
        "clavePS": "",
        "unity": "Centro",
        "claveUnity": "44640"
      }
    ]
  }
]

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.