> ## Documentation Index
> Fetch the complete documentation index at: https://developers.readyforcommerce.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar importaciones

> Lista las importaciones de la organización, de la más nueva a la más antigua, con el archivo, el estado, los conteos y quién inició cada una. La búsqueda lee el nombre del archivo; el filtro lee file, entity, mode, fields (cuántos campos asigna), state (active, succeeded, withErrors, failed o canceled) y los conteos de filas success, warning, error y blocked.



## OpenAPI

````yaml /openapi/es.json get /api/v1/orgs/{orgId}/core/imports
openapi: 3.1.0
info:
  title: API de Ready for Commerce
  version: 1.0.0
  description: >-
    La referencia de cada operación de la API de Ready for Commerce. Todas las
    operaciones están en beta hasta el lanzamiento.
servers:
  - url: https://app.readyforcommerce.com
security:
  - apiKey: []
tags:
  - name: Credentials
    x-group: Credenciales
    description: >-
      La credencial que llama: su organización, sus permisos, sus límites y las
      llamadas que aún puede hacer.
  - name: Organization
    x-group: Organización
    description: 'Los ajustes de la organización: su nombre, su slug y su moneda.'
  - name: Billing
    x-group: Facturación
    description: >-
      La suscripción de la organización, la factura y el tope de cada módulo, y
      el uso del mes frente a su cuota gratuita.
  - name: Record types
    x-group: Tipos de registro
    description: >-
      Los tipos de registro que la credencial puede importar o exportar, con los
      campos y opciones de cada uno.
  - name: Imports
    x-group: Importaciones
    description: >-
      Para traer archivos CSV o Excel: subir o traer un archivo, inspeccionarlo
      y revisarlo, iniciar la importación y leer sus resultados.
  - name: Files
    x-group: Archivos
    description: El estado de un archivo subido, hasta que queda listo o rechazado.
  - name: Exports
    x-group: Exportaciones
    description: >-
      Para exportar a archivos CSV o Excel los registros que coinciden con un
      filtro; se guardan 14 días.
  - name: Export templates
    x-group: Plantillas de exportación
    description: >-
      Configuraciones de exportación guardadas con un nombre, para repetir la
      misma exportación.
  - name: Jobs
    x-group: Trabajos
    description: >-
      Las tareas largas corren como trabajos: su estado y su avance, sus
      mensajes, sus archivos para descargar o su cancelación.
  - name: Search
    x-group: Búsqueda
    description: >-
      Encuentra los registros de la organización por palabras, aunque lleven una
      errata, agrupados por tipo.
  - name: Version history
    x-group: Historial de versiones
    description: >-
      Las versiones de un registro, de la más nueva a la más antigua:
      compararlas y restaurar el registro a una de ellas.
  - name: Incidents
    x-group: Incidencias
    description: >-
      Los problemas de la organización que puedes ver: marcarlos como leídos o
      no leídos y resolverlos.
  - name: Notifications
    x-group: Notificaciones
    description: >-
      Tus notificaciones, de la más nueva a la más antigua: marcar una como
      leída o no leída, o todas como leídas.
  - name: Saved views
    x-group: Vistas guardadas
    description: >-
      La búsqueda, los filtros, el orden y las columnas de una tabla guardados
      con un nombre, tuyos o compartidos con la organización, y la vista con la
      que se abre cada tabla para ti.
  - name: Store connections
    x-group: Conexiones de tienda
    description: >-
      Las tiendas de la organización, conectadas con sus credenciales pegadas:
      listarlas, conectar una, reconectarla con credenciales nuevas o
      desconectarla.
  - name: Products
    x-group: Productos
    description: >-
      Los productos de la organización con sus opciones, variantes y precios:
      listarlos, leer uno, crear uno, cambiar el contenido, los precios o el
      estado de uno, duplicar uno como borrador, o eliminar uno.
paths:
  /api/v1/orgs/{orgId}/core/imports:
    get:
      tags:
        - Imports
      summary: Listar importaciones
      description: >-
        Lista las importaciones de la organización, de la más nueva a la más
        antigua, con el archivo, el estado, los conteos y quién inició cada una.
        La búsqueda lee el nombre del archivo; el filtro lee file, entity, mode,
        fields (cuántos campos asigna), state (active, succeeded, withErrors,
        failed o canceled) y los conteos de filas success, warning, error y
        blocked.
      operationId: coreListImports
      parameters:
        - schema:
            type: string
          in: query
          name: q
          required: false
        - schema:
            type: string
          in: query
          name: cursor
          required: false
        - schema:
            default: 200
            type: integer
            minimum: 1
            maximum: 200
          in: query
          name: limit
          required: false
        - schema:
            type: string
            enum:
              - 'true'
          in: query
          name: withTotal
          required: false
        - schema:
            type: string
            format: uuid
          in: path
          name: orgId
          required: true
      responses:
        '200':
          description: Correcto
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportPage'
        default:
          description: >-
            Un error, como `application/problem+json`: su `code` dice qué salió
            mal y `params` lleva sus valores
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/Problem'
                  - properties:
                      code:
                        enum:
                          - core.bad_request
                          - core.invalid_credential
                          - core.forbidden
                          - core.module_not_enabled
                          - core.module_read_only
                          - core.not_found
                          - core.conflict
                          - core.org_deletion_scheduled
                          - core.payload_too_large
                          - core.unsupported_media_type
                          - core.validation_failed
                          - core.rate_limited
                          - core.surface_disabled
                          - core.internal
                          - core.unavailable
components:
  schemas:
    ImportPage:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ImportItem'
        nextCursor:
          type:
            - string
            - 'null'
        total:
          type: integer
      required:
        - items
        - nextCursor
      additionalProperties: false
    Problem:
      type: object
      properties:
        type:
          type: string
          pattern: ^urn:rfc:problem:[\s\S]{0,}\.[\s\S]{0,}$
        status:
          type: integer
        title:
          type: string
        code:
          type: string
          pattern: ^[\s\S]{0,}\.[\s\S]{0,}$
        params:
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
        requestId:
          type: string
        errors:
          type: array
          items:
            type: object
            properties:
              location:
                type: string
              pointer:
                type: string
              code:
                type: string
              params:
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
            required:
              - location
              - pointer
              - code
            additionalProperties: false
      required:
        - type
        - status
        - code
        - requestId
      additionalProperties: false
    ImportItem:
      oneOf:
        - type: object
          properties:
            id:
              type: string
              format: uuid
            waitingReason:
              anyOf:
                - type: string
                  enum:
                    - paused
                - type: 'null'
            progress:
              type: object
              properties:
                done:
                  type: integer
                total:
                  anyOf:
                    - type: integer
                    - type: 'null'
              required:
                - done
                - total
              additionalProperties: false
            apiKey:
              anyOf:
                - type: object
                  properties:
                    name:
                      type: string
                  required:
                    - name
                  additionalProperties: false
                - type: 'null'
            createdAt:
              type: string
              format: date-time
            finishedAt:
              anyOf:
                - type: string
                  format: date-time
                - type: 'null'
            canCancel:
              type: boolean
            file:
              type: object
              properties:
                name:
                  type:
                    - string
                    - 'null'
                expired:
                  type: boolean
              required:
                - name
                - expired
              additionalProperties: false
            permission:
              type: string
            module:
              type: string
              enum:
                - core
                - integrations
                - catalog
                - pricing
            createdBy:
              anyOf:
                - type: object
                  properties:
                    id:
                      type: string
                      format: uuid
                    name:
                      type:
                        - string
                        - 'null'
                  required:
                    - id
                    - name
                  additionalProperties: false
                - type: 'null'
            entity:
              type: string
            mode:
              type: string
              enum:
                - create
                - update
                - clean
                - delete
            fields:
              type: integer
            counters:
              type: object
              properties:
                success:
                  type: integer
                warning:
                  type: integer
                error:
                  type: integer
                blocked:
                  type: integer
              required:
                - success
                - warning
                - error
                - blocked
              additionalProperties: false
            state:
              type: string
              const: failed
            error:
              type: object
              properties:
                code:
                  type: string
                params:
                  type: object
                  propertyNames:
                    type: string
                  additionalProperties:
                    type:
                      - string
                      - number
              required:
                - code
                - params
              additionalProperties: false
          required:
            - id
            - waitingReason
            - progress
            - apiKey
            - createdAt
            - finishedAt
            - canCancel
            - file
            - permission
            - module
            - createdBy
            - entity
            - mode
            - fields
            - counters
            - state
            - error
          additionalProperties: false
        - type: object
          properties:
            id:
              type: string
              format: uuid
            waitingReason:
              anyOf:
                - type: string
                  enum:
                    - paused
                - type: 'null'
            progress:
              type: object
              properties:
                done:
                  type: integer
                total:
                  anyOf:
                    - type: integer
                    - type: 'null'
              required:
                - done
                - total
              additionalProperties: false
            apiKey:
              anyOf:
                - type: object
                  properties:
                    name:
                      type: string
                  required:
                    - name
                  additionalProperties: false
                - type: 'null'
            createdAt:
              type: string
              format: date-time
            finishedAt:
              anyOf:
                - type: string
                  format: date-time
                - type: 'null'
            canCancel:
              type: boolean
            file:
              type: object
              properties:
                name:
                  type:
                    - string
                    - 'null'
                expired:
                  type: boolean
              required:
                - name
                - expired
              additionalProperties: false
            permission:
              type: string
            module:
              type: string
              enum:
                - core
                - integrations
                - catalog
                - pricing
            createdBy:
              anyOf:
                - type: object
                  properties:
                    id:
                      type: string
                      format: uuid
                    name:
                      type:
                        - string
                        - 'null'
                  required:
                    - id
                    - name
                  additionalProperties: false
                - type: 'null'
            entity:
              type: string
            mode:
              type: string
              enum:
                - create
                - update
                - clean
                - delete
            fields:
              type: integer
            counters:
              type: object
              properties:
                success:
                  type: integer
                warning:
                  type: integer
                error:
                  type: integer
                blocked:
                  type: integer
              required:
                - success
                - warning
                - error
                - blocked
              additionalProperties: false
            state:
              type: string
              enum:
                - waiting
                - running
                - succeeded
                - canceled
            error:
              type: 'null'
          required:
            - id
            - waitingReason
            - progress
            - apiKey
            - createdAt
            - finishedAt
            - canCancel
            - file
            - permission
            - module
            - createdBy
            - entity
            - mode
            - fields
            - counters
            - state
            - error
          additionalProperties: false
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        Una llave de API de la organización, enviada en cada llamada como
        `Authorization: Bearer <llave>`. La crea una persona de la organización
        en la aplicación, en **Ajustes › API y conexiones › Llaves de API**.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.