Ir al contenido
Tiendas en línea

FISCALISTO / API / REFERENCIA

Ver una tienda

Abrir en ChatGPTAbrir en Claude
GET
/v1/store_connections/{id}

Una tienda conectada (Shopify, Mercado Libre o WooCommerce), su estado y lo último que importó.

Autorización

bearerAuth
headerAutorizaciónBearer <llave>

Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.

Parámetros de la ruta

id*string

El id del objeto.

Cuerpo de la respuesta

Correcto.

application/json
  1. response

Una tienda de Shopify o Mercado Libre cuyos pedidos pagados se vuelven tickets de autofactura del emisor.

id*string

Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).

livemode*boolean

true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.

object*string

Qué tipo de objeto es («invoice», «customer»…).

issuer*string

El emisor dueño de la tienda.

platform*string

shopify o mercadolibre.

Uno de"shopify""mercadolibre"
shop*|

El dominio de la tienda de Shopify, o el id del vendedor en Mercado Libre (al autorizar).

status*string

pending (Mercado Libre espera que el vendedor autorice en authorize_url), active o disconnected.

Uno de"pending""active""disconnected"
authorize_url*|

Si está pending: la página de Mercado Libre donde el vendedor autoriza (vale un día; cada consulta da una nueva). Si no, null.

settings*

Cómo se vuelve ticket cada pedido.

orders_count*integer

Cuántos pedidos se han vuelto tickets.

Rango-9007199254740991 <= value <= 9007199254740991
last_order_at*|

Cuándo llegó el último, o null.

last_error*|

El último problema (un pedido en dólares, un ticket que ya se facturó cuando se canceló el pedido…), o null.

created_at*|

Cuándo se conectó.

curl -X GET 'https://api.fiscalisto.com/v1/store_connections/string' \  -H 'Authorization: Bearer fk_test_…'
{  "id": "stc_OufpKqnrvx9p3Kd8sLm2XyT5uBcW8sKdLx",  "object": "store_connection",  "livemode": false,  "issuer": "iss_OufpKqnrvx9p",  "platform": "shopify",  "shop": "mi-tienda.myshopify.com",  "status": "active",  "authorize_url": null,  "settings": {    "product_key": "53101600",    "unit_key": null,    "iva": "0.16",    "description": null,    "folio_prefix": "SHOP-",    "payment_form": null,    "payment_forms": {      "paypal": "31"    },    "auto_invoice": null  },  "orders_count": 128,  "last_order_at": "2026-10-25T10:12:44-06:00",  "last_error": null,  "created_at": "2026-10-01T09:00:00-06:00"}

Conectar una tienda POST

Shopify: con el dominio y las llaves de la app de la tienda (Dev Dashboard, permisos read_orders y write_orders) registra los webhooks y queda active. Mercado Libre: queda pending hasta que el vendedor autorice en authorize_url. Desde entonces cada pedido pagado es un ticket (folio SHOP-1001 o ML-…), que su comprador factura en el portal o entra en la factura global; un pedido cancelado o reembolsado completo cancela su ticket.

Cambiar cómo se vuelven tickets sus pedidos POST

Cuenta para los pedidos que lleguen; los tickets ya hechos no cambian.