Skip to main content
GET
/
productos
/
{productoId}
Obtener producto
curl --request GET \
  --url https://rest.yafacture.com/productos/{productoId} \
  --header 'x-api-key: <api-key>'
const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://rest.yafacture.com/productos/{productoId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
import requests

url = "https://rest.yafacture.com/productos/{productoId}"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://rest.yafacture.com/productos/{productoId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
HttpResponse<String> response = Unirest.get("https://rest.yafacture.com/productos/{productoId}")
.header("x-api-key", "<api-key>")
.asString();
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://rest.yafacture.com/productos/{productoId}"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("x-api-key", "<api-key>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
{
  "_id": "<string>",
  "emisorId": "<string>",
  "noIdentificacion": "",
  "claveProdServ": "",
  "claveUnidad": "",
  "descripcion": "<string>",
  "descuento": 0,
  "precio": 1,
  "precio2": 0,
  "precio3": 0,
  "inventario": 0,
  "reservado": 0,
  "objetoImp": "02",
  "iva": "masIva",
  "sku": "",
  "codigoEan": "",
  "codigoAsin": "",
  "codigoMl": "",
  "codigoAmazon": "",
  "thumbnail": "",
  "imagenes": [],
  "resumen": "",
  "atributos": [],
  "origen": "app",
  "fecha": "2026-05-17T02:51:34.367Z",
  "status": true
}
{
"message": "Forbidden resource",
"error": "Forbidden",
"statusCode": 403
}

Authorizations

x-api-key
string
header
required

X-API-Key authentication header for the development token generated in Yafacture

Path Parameters

productoId
string
required

Query Parameters

cols
string
required

Response

Producto encontrado

_id
string
required

Identificador único del producto

emisorId
string
required

Identificador único del producto

noIdentificacion
string
default:""
required

SKU (Stock Keeping Unit) del producto

Maximum string length: 100
claveProdServ
string
default:""
required

Número de identificación del producto

claveUnidad
string
default:""
required

Clave de producto o servicio según catálogo del SAT

descripcion
string
required

Clave de unidad de medida según catálogo del SAT

descuento
number
default:0
required

Descuento aplicado al producto

Required range: x >= 0
precio
number
required

Precio unitario del producto

Required range: x >= 0
precio2
number
default:0
required

Precio alternativo 2

Required range: x >= 0
precio3
number
default:0
required

Precio alternativo 3

Required range: x >= 0
inventario
number
default:0
required

Cantidad en inventario

reservado
number
default:0
required

Cantidad de inventario reservado

objetoImp
string
default:02
required

Objeto de impuesto según catálogo del SAT

iva
enum<string>
default:masIva
required

Tasa de IVA aplicada

Available options:
noAplica,
masIva,
desglosar,
desglosarIvaDesglosarIsr,
masIvaFrontera,
desglosarFrontera,
exento,
noAplicaMenosIsr,
noAplicaDesglosarIsr,
tasa0
sku
string
default:""
required

Identificador sku 1 del emisor

Maximum string length: 100
codigoEan
string
default:""
required

Identificador sku 2 del emisor

Maximum string length: 100
codigoAsin
string
default:""
required

Identificador sku 3 del emisor

Maximum string length: 100
codigoMl
string
default:""
required

Identificador sku 3 del emisor

Maximum string length: 100
codigoAmazon
string
default:""
required

Identificador sku 4 del emisor

Maximum string length: 100
thumbnail
string
default:""
required

Imagen en miniatura del producto

imagenes
string[]
required

Listado de imágenes de producto

resumen
string
default:""
required

Resumen o descripción corta del producto

atributos
string[]
required

Atributos adicionales del producto

origen
enum<string>
default:app
required

Origen del registro (app, api, importación, etc.)

Available options:
app,
api,
upload,
download,
mercadolibre,
mercadopago,
autofactura,
transferencia
fecha
string<date-time>
default:2026-05-17T02:51:34.367Z
required

Fecha del registro

status
boolean
default:true
required

Estado activo/inactivo del producto