FiestaDigital

Importar lote: comercios. Crea o edita hasta 50 registros de este recurso; máximo 96 KiB UTF-8 por lote. data usa los campos de compras_comercios_crear o compras_comercios_editar; al editar añade id e ifMatch. Cada entrada tiene idempotencyKey propia. Altas en borrador; editar publicado lo retira a borrador. Resultado parcial: revisa succeeded, failed e items por index aunque ok=true. Recuperación y dependencias: leer_instrucciones_importacion. No admite borrado, publicación ni pagos.

Listar comercios. Localiza registros con q antes de recorrer el catálogo. Usa view=summary para resolver IDs y view=full para comparar contenido. Conserva q y filtros al continuar con nextCursor hasta null.

Consultar productos. Devuelve la ficha editorial completa y su ETag. Lee el detalle antes de editar; conserva el ETag con comillas para ifMatch.

Crear productos. Crea un borrador. Asocia el comercio real; category describe el tipo de producto. Precio desconocido no equivale a cero.

Editar productos. Editar publicado lo retira a borrador. Envía solo campos que cambian, con ifMatch del detalle actual; omite la edición si no hay diferencias. category es el tipo de producto; omitir un precio desconocido conserva el existente.

Eliminar productos. Elimina el registro indicado con ifMatch del detalle actual. No borres registros solo por faltar en una fuente importada.

Importar lote: productos. Crea o edita hasta 50 registros de este recurso; máximo 96 KiB UTF-8 por lote. data usa los campos de compras_productos_crear o compras_productos_editar; al editar añade id e ifMatch. Cada entrada tiene idempotencyKey propia. Altas en borrador; editar publicado lo retira a borrador. Resultado parcial: revisa succeeded, failed e items por index aunque ok=true. Recuperación y dependencias: leer_instrucciones_importacion. No admite borrado, publicación ni pagos.

Listar productos. Localiza registros con q antes de recorrer el catálogo. Usa view=summary para resolver IDs y view=full para comparar contenido. Conserva q y filtros al continuar con nextCursor hasta null. Filtra el catálogo por commerceEntryId.

Consultar sitio, edición, zona horaria y festividades. Obtén edición, permisos, módulos, solo lectura, zona horaria, idiomas y festividad predeterminada del destino. Usa la configuración devuelta sin pedir IDs ni idiomas al usuario. Para importar, aplica las pautas comunes disponibles en leer_instrucciones_importacion; reutilízalas si ya llegaron completas en la inicialización MCP.

Consultar articulos. Devuelve la ficha editorial completa y su ETag. Lee el detalle antes de editar; conserva el ETag con comillas para ifMatch.

Crear articulos. Creación en borrador. Antes de importar, consulta consultar_contexto y leer_instrucciones_importacion; resuelve identificadores internamente, sin pedirlos al usuario. Identifica cada producto antes de elegir categoryId: reutiliza una categoría específica equivalente o créala; no uses una genérica solo porque exista. Prepara searchKeywords con sinónimos y variantes, y traducciones según el contexto, aunque el usuario no los enumere. Comprueba duplicados dentro del establecimiento. En una importación sin fuente accesible, pide el adjunto antes de escribir.

Editar articulos. Editar publicado lo retira a borrador. Antes de importar, consulta consultar_contexto y leer_instrucciones_importacion; resuelve identificadores internamente, sin pedirlos al usuario. Para una importación: Identifica cada producto antes de elegir categoryId: reutiliza una categoría específica equivalente o créala; no uses una genérica solo porque exista. Prepara searchKeywords con sinónimos y variantes, y traducciones según el contexto, aunque el usuario no los enumere. Comprueba duplicados dentro del establecimiento. En una importación sin fuente accesible, pide el adjunto antes de escribir. En una corrección puntual, cambia solo los campos solicitados y conserva los demás datos y traducciones.

Eliminar articulos. Elimina el registro indicado con ifMatch del detalle actual. No borres registros solo por faltar en una fuente importada.

Listar articulos. Localiza registros con q antes de recorrer el catálogo. Usa view=summary para resolver IDs y view=full para comparar contenido. Conserva q y filtros al continuar con nextCursor hasta null. Filtra la carta por establishmentId.

Consultar categorias. Devuelve la ficha editorial completa y su ETag. Lee el detalle antes de editar; conserva el ETag con comillas para ifMatch.

Crear categorias. Creación en borrador. Antes de importar, consulta consultar_contexto y leer_instrucciones_importacion; resuelve identificadores internamente, sin pedirlos al usuario. Reutiliza categorías específicas equivalentes; crea las que falten para clasificar el contenido, con traducciones. No renombres categorías compartidas para adaptar una sola carta. En una importación sin fuente accesible, pide el adjunto antes de escribir.

Editar categorias. Editar publicado lo retira a borrador. Envía solo campos que cambian, con ifMatch del detalle actual; omite la edición si no hay diferencias. No renombres categorías compartidas para adaptar una sola carta.

Eliminar categorias. Elimina el registro indicado con ifMatch del detalle actual. No borres registros solo por faltar en una fuente importada. Una categoría utilizada devuelve 409 dependency_conflict; no retires artículos para eludirlo.

Listar categorias. Localiza registros con q antes de recorrer el catálogo. Usa view=summary para resolver IDs y view=full para comparar contenido. Conserva q y filtros al continuar con nextCursor hasta null.

Consultar establecimientos. Devuelve la ficha editorial completa y su ETag. Lee el detalle antes de editar; conserva el ETag con comillas para ifMatch.

Crear establecimientos. Crea un borrador. Usa el nombre verificable del establecimiento; no inventes contacto ni horarios.

Editar establecimientos. Editar publicado lo retira a borrador. Envía solo campos que cambian, con ifMatch del detalle actual; omite la edición si no hay diferencias.

Eliminar establecimientos. Elimina el registro indicado con ifMatch del detalle actual. No borres registros solo por faltar en una fuente importada. Si contiene artículos devuelve 409 dependency_conflict; no borres la carta para eludir el conflicto.

Importar lote: establecimientos. Crea o edita hasta 50 registros de este recurso; máximo 96 KiB UTF-8 por lote. data usa los campos de gastronomia_establecimientos_crear o gastronomia_establecimientos_editar; al editar añade id e ifMatch. Cada entrada tiene idempotencyKey propia. Altas en borrador; editar publicado lo retira a borrador. Resultado parcial: revisa succeeded, failed e items por index aunque ok=true. Recuperación y dependencias: leer_instrucciones_importacion. No admite borrado, publicación ni pagos.

Listar establecimientos. Localiza registros con q antes de recorrer el catálogo. Usa view=summary para resolver IDs y view=full para comparar contenido. Conserva q y filtros al continuar con nextCursor hasta null.

Leer pautas de clasificación, búsqueda e importación. Guía editorial común para importar desde texto, fotos o documentos: fuente, destino, clasificación y ejemplos ambiguos, contenido de textos, idiomas, duplicados, lotes y recuperación de errores. Léela una vez por carga y reutilízala; una consulta o corrección puntual no requiere preparar una importación.

Sitios accesibles y sus ediciones activas. Resuelve siteId y edition sin pedir identificadores al usuario: usa el destino indicado si está autorizado o el único disponible cuando no se indique otro. Si hay varios destinos y falta una referencia inequívoca, pregunta por nombre antes de escribir; nunca sustituyas un destino no autorizado.

Identidad de la cuenta conectada a FiestaDigital.

Consultar banners. Devuelve la ficha editorial completa y su ETag. Lee el detalle antes de editar; conserva el ETag con comillas para ifMatch.

Crear banners. Crea un borrador. Nuevos huecos fijos: periodMode=year|festivity. Actividades: beforeAgendaItemId y dates, sin vigencia independiente. No inicia pagos ni publica; requiere pago confirmado y publicación manual desde el admin.

Editar banners. Editar publicado lo retira a borrador. Envía solo campos que cambian, con ifMatch del detalle actual; omite la edición si no hay diferencias. Omite campos comerciales al corregir creatividad; reenviar un calendario histórico exige conservar exactamente su cobertura. Las ampliaciones requieren revisión desde el panel. No inicia pagos ni publica; requiere pago confirmado y publicación manual desde el admin.

Eliminar banners. Elimina el registro indicado con ifMatch del detalle actual. No borres registros solo por faltar en una fuente importada. Un pago confirmado impide borrarlo: payment_record_preserved.

Listar banners. Devuelve una página editorial de borradores y publicados autorizados. Continúa con nextCursor hasta null; no admite q ni view=summary.

Consultar promociones. Devuelve la ficha editorial completa y su ETag. Lee el detalle antes de editar; conserva el ETag con comillas para ifMatch.

Crear promociones. Crea un borrador. Nuevas fechas: días completos locales, startTime=endTime=00:00 y límites UTC coherentes con el cambio horario. No inicia pagos ni publica; requiere pago confirmado y publicación manual desde el admin.

Editar promociones. Editar publicado lo retira a borrador. Envía solo campos que cambian, con ifMatch del detalle actual; omite la edición si no hay diferencias. Omite campos comerciales al corregir creatividad; reenviar un calendario histórico exige conservar exactamente su cobertura. Las ampliaciones requieren revisión desde el panel. No inicia pagos ni publica; requiere pago confirmado y publicación manual desde el admin.

Eliminar promociones. Elimina el registro indicado con ifMatch del detalle actual. No borres registros solo por faltar en una fuente importada. Un pago confirmado impide borrarlo: payment_record_preserved.

Listar promociones. Devuelve una página editorial de borradores y publicados autorizados. Continúa con nextCursor hasta null; no admite q ni view=summary.