---
title: "Esquema de datos ONIX 3"
canonical: "https://docs.holnix.com/space/HW/388169745/Esquema%20de%20datos%20ONIX%203"
format: markdown
---
La API de Holnix utiliza el [estándar ONIX 3 ](https://www.editeur.org/12/About-Release-3.0-and-3.1/)para estructurar y devolver los metadatos de los libros. Este esquema es ampliamente utilizado en la industria editorial por su capacidad de proporcionar descripciones detalladas, información comercial y recursos asociados a los productos. 

A continuación, se describe la estructura de un registro típico devuelto por la API, junto con los elementos adicionales proporcionados por Holnix para facilitar su contexto.

## **Estructura del Esquema**

### **Identificadores del Producto (**ProductIdentifier**)**:

- Contiene una lista de identificadores únicos para el libro, como ISBN y otros valores específicos del sistema.
- Ejemplo:

```json
[
  {
    "ProductIDType": "03",
    "IDValue": "9780789928405"
  },
  {
    "ProductIDType": "15",
    "IDValue": "9780789928405"
  },
  {
    "ProductIDType": "01",
    "IDTypeName": "ONIX_NOSEQ",
    "IDValue": "dc13adee-8c48-460e-a2b5-bc9a0341d466"
  }
]
```

### **Detalles Descriptivos (**DescriptiveDetail**)**:

- Incluye características clave del producto, como su formato, idioma, dimensiones, contribuyentes (autores), y temática.
- Ejemplo:

```json
{
  "ProductForm": "BC",
  "Measure": [
    {"MeasureType": "01", "Measurement": "9.45", "MeasureUnitCode": "in"},
    {"MeasureType": "02", "Measurement": "6.50", "MeasureUnitCode": "in"},
    {"MeasureType": "03", "Measurement": "0.19", "MeasureUnitCode": "in"}
  ],
  "TitleDetail": {
    "TitleElement": {"TitleText": "Los 5 lenguajes del amor para hombres"}
  },
  "Contributor": {"PersonName": "Gary Chapman"}
}
```

### **Detalles Colaterales (**CollateralDetail**)**:

- Contiene información promocional como textos descriptivos y recursos multimedia (imágenes, videos).
- Ejemplo:

```
{
  "TextContent": [
    {
      "TextType": "12",
      "ContentAudience": "00",
      "Text": "Autor y conferenciante..."
    }
  ],
  "SupportingResource": {
    "ResourceContentType": "01",
    "ResourceVersion": {
      "ResourceLink": "https://www.editorialunilit.com/media/catalog/product/p/o/portada.jpeg"
    }
  }
}
```

### **Detalles de Publicación (**PublishingDetail**)**:

- Información sobre el editor, la imprenta, y la disponibilidad del libro.
- Ejemplo:

```
{
  "Imprint": {"ImprintName": "Editorial Unilit"},
  "Publisher": {
    "PublisherName": "Editorial Unilit",
    "Website": {"WebsiteLink": "https://www.editorialunilit.com"}
  },
  "PublishingStatus": "04",
  "PublishingDate": {"Date": "20241115"}
}
```

### **Suministro del Producto (**ProductSupply**)**:

- Describe la disponibilidad, condiciones de devolución y precios del producto.
- Ejemplo:

```json
{
  "SupplyDetail": {
    "ProductAvailability": "11",
    "Price": {
      "PriceType": "01",
      "PriceAmount": "10.99",
      "CurrencyCode": "USD"
    }
  }
}
```

### **Elementos Adicionales Proporcionados por Holnix**

Holnix añade elementos específicos para mejorar la usabilidad de los datos:

1. **Fechas de creación y actualización del registro**:

- created_at: Fecha en que el registro fue creado.
- updated_at: Fecha de la última actualización.
- Ejemplo:

```
{
  "created_at": "2024-07-10T07:35:30.720000Z",
  "updated_at": "2024-11-29T12:10:21.448000Z"
}
```

### **Imágenes miniatura**:

- HolnixImages: Proporciona una miniatura para facilitar la visualización en interfaces gráficas con poca carga de datos (imagen pequeña).
- Ejemplo:

```json
{
  "HolnixImages": {
    "Thumbnail": "https://holnix.s3.eu-west-3.amazonaws.com/images/9780789928405_th.jpeg"
  }
}
```

### **Resumen del Esquema**

El esquema ONIX 3 implementado por Holnix es altamente detallado, cubriendo desde la identificación del producto hasta su comercialización. Los elementos adicionales proporcionados por Holnix ayudan a contextualizar y optimizar el uso de los datos para diversas aplicaciones.