Scopes y permisos

​

Catálogo

​

Reglas

• write_x implica read_x. Si pedís write_stock ya podés leer el stock; no hace falta pedir también read_stock.
• read_shops siempre está. Todas las instalaciones pueden listar las sucursales.
• read_costs no va solo. Sólo se puede pedir junto con read_products o read_orders (o sus versiones write_). Aparece destacado en la pantalla de consentimiento con un aviso de que se trata de información sensible, y hay que justificarlo en la revisión.
• Los webhooks de un recurso exigen su read_. Una instalación sin read_orders no recibe order.created, aunque esté suscripta. Los 4 webhooks obligatorios se entregan a todas las instalaciones.
• Nunca se exponen datos fiscales. Ningún recurso de la API v1 devuelve CUIT, CUIL, razón social ni condición frente al IVA. Sólo se informa un DNI cuando el comerciante lo cargó como DNI.
• La instalación ve todas las sucursales del comercio, no se puede acotar a algunas.
• Los scopes no se reducen en silencio. Si ampliás los scopes de tu app, los comerciantes ya instalados mantienen los anteriores hasta que vuelvan a autorizar.

​

Qué pasa si falta un scope

{
  "error": {
    "code": "insufficient_scope",
    "message": "La instalación no tiene el scope read_orders",
    "details": [{ "required_scope": "read_orders" }],
    "request_id": "0b6f6d3e-6c0e-4c0b-9a5a-6a8f6d1c2a10"
  }
}