Guía de integración para desarrolladores, POS y LLMs
Ejemplos listos para producción en Python, PHP, Node.js y automatizaciones
La API responde sin necesidad de crear cuentas ni solicitar tokens para el uso estándar, soporta peticiones desde navegador con CORS abierto (*) y alimenta en producción la validación en vivo de UrbanStock POS (Windows, Android y WebApp).
Ejemplo en Node.js / TypeScript (RNC + NCF)
const url =
"https://rnc.urbanstockpos.com/api/v1/rnc/000000000";
const res = await fetch(url);
const { data, meta } = await res.json();
if (data?.isActive && meta.validCheckDigit) {
console.log(data.formattedRnc, data.razonSocial);
}Ejemplo en Python (requests) & PHP
# Python import requests r = requests.get( "https://rnc.urbanstockpos.com/api/v1/rnc/000000000", timeout=5, ).json() // PHP $url = "https://rnc.urbanstockpos.com/api/v1/rnc/000000000"; $json = json_decode(file_get_contents($url), true);
Optimización con ETag (304 Not Modified) y pruebas seguras
Cada consulta puntual incluye cabecera
ETag ligada a la versión diaria del padrón. Si envías If-None-Match, el servidor responde 304 Not Modified casi sin latencia. Para pruebas usa siempre 000000000, 00000000000 o EMPRESA DE PRUEBA.