# Integraciones

Descripción de los objetos correspondientes a los modelos de datos de cada entidad manejada en esta documentación.

## Orden

<table data-full-width="false"><thead><tr><th width="254">Clave</th><th width="224">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>⚠️ <strong><code>numeroOrden</code></strong></td><td>Numeric</td><td>Número de la orden.<br><strong>OBSOLETO.</strong> Utilizar <strong><code>idOrden</code></strong>.</td></tr><tr><td><strong><code>idOrden</code></strong></td><td>String(32)</td><td>Identificador de la orden en Fenicio.</td></tr><tr><td><strong><code>idOrdenOrigen</code></strong></td><td>String(32) | null</td><td>Identificador de la orden en su origen, en caso de haber sido generada en un origen externo a Fenicio (por ejemplo un marketplace).</td></tr><tr><td><strong><code>referencia</code></strong></td><td>String(32) | null</td><td>Identificador único de referencia con el cual se registró la orden en el sistema del comercio.</td></tr><tr><td><strong><code>estado</code></strong></td><td><a href="/pages/LjX6E6o8pT0EpYonxgLH#estadoorden"><strong>EstadoOrden</strong></a></td><td>Estado de la orden en Fenicio.</td></tr><tr><td><strong><code>motivoCancelacion</code></strong></td><td>String(255) | null</td><td>Texto descriptivo del motivo de la cancelación.</td></tr><tr><td><strong><code>origen</code></strong></td><td>String</td><td>Origen de la orden. Posibles valores: <strong><code>MERCADOLIBRE</code></strong>, <strong><code>CALLCENTER</code></strong>, <strong><code>WEB</code></strong>,<strong><code>PEDIDO</code></strong>.</td></tr><tr><td><strong><code>fechaInicio</code></strong></td><td><a href="/pages/LjX6E6o8pT0EpYonxgLH#datetime"><strong>DateTime</strong></a></td><td>Fecha de iniciada la orden.</td></tr><tr><td><strong><code>fechaAbandono</code></strong></td><td><a href="/pages/LjX6E6o8pT0EpYonxgLH#datetime"><strong>DateTime</strong></a> | null</td><td>Fecha de abandono de la orden.</td></tr><tr><td><strong><code>fechaRecuperada</code></strong></td><td><a href="/pages/LjX6E6o8pT0EpYonxgLH#datetime"><strong>DateTime</strong></a> | null</td><td>Fecha de recuperación de la orden.</td></tr><tr><td><strong><code>fechaFin</code></strong></td><td><a href="/pages/LjX6E6o8pT0EpYonxgLH#datetime"><strong>DateTime</strong></a> | null</td><td>Fecha de finalizada la orden.</td></tr><tr><td><strong><code>fechaCancelada</code></strong></td><td><a href="/pages/LjX6E6o8pT0EpYonxgLH#datetime"><strong>DateTime</strong></a> | null</td><td>Fecha de cancelación de la orden.</td></tr><tr><td><strong><code>comprador</code></strong></td><td><a href="#comprador"><strong>Comprador</strong></a></td><td>Datos del comprador.</td></tr><tr><td><strong><code>direccionFacturacion</code></strong></td><td><a href="#direccion"><strong>Direccion</strong></a> | null</td><td>Dirección de facturación de la orden.</td></tr><tr><td><strong><code>codigoTributario</code></strong></td><td>String(32) | null</td><td>Número de registro tributario de la empresa.</td></tr><tr><td><strong><code>razonSocial</code></strong></td><td>String(64) | null</td><td>Nombre legal de la empresa.</td></tr><tr><td><strong><code>moneda</code></strong></td><td>String(4)</td><td>Código ISO 4217 de la moneda. Ejemplo: UYU</td></tr><tr><td><strong><code>pago</code></strong></td><td><a href="#pago"><strong>Pago</strong></a> | null</td><td>Datos del pago realizado para la orden.</td></tr><tr><td><strong><code>entrega</code></strong></td><td><a href="#ordenentrega"><strong>OrdenEntrega</strong></a> | null</td><td>Datos de como se entregará la orden realizada.</td></tr><tr><td><strong><code>lineas</code></strong></td><td>List&#x3C;<a href="#ordenlinea"><strong>OrdenLinea</strong></a>></td><td>Líneas de productos asociadas a la orden.</td></tr><tr><td><strong><code>impuestos</code></strong></td><td>Numeric</td><td>Monto total de impuestos de la orden.</td></tr><tr><td><strong><code>importeTotal</code></strong></td><td>Numeric</td><td>Importe total final de la orden.</td></tr><tr><td><strong><code>observaciones</code></strong></td><td>String (255) | null</td><td>Observaciones adicionales de la orden. </td></tr><tr><td><strong><code>historialCallCenter</code></strong></td><td>List&#x3C;<a href="#eventocallcenter"><strong>EventoCallCenter</strong></a>></td><td>Historial de acciones realizadas desde call center.</td></tr><tr><td><strong><code>_idSolicitud</code></strong></td><td>string</td><td>Identificador interno de la solicitud.</td></tr></tbody></table>

## OrdenLinea

<table data-full-width="false"><thead><tr><th width="260.3333333333333">Clave</th><th width="219">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong><code>nombre</code></strong></td><td>String(255)</td><td>Nombre del artículo.</td></tr><tr><td><strong><code>sku</code></strong></td><td>String(128)</td><td>Código único que identifica al artículo en el sistema externo.</td></tr><tr><td><strong><code>skuFenicio</code></strong></td><td>String(128)</td><td>Código único que identifica al artículo en Fenicio.</td></tr><tr><td><strong><code>codigoPrecio</code></strong></td><td>String(16)</td><td>Código que corresponde al tipo de precio del artículo. Si el artículo corresponde a precios alternativos, se devolverá el código con el que ingresó, de lo contrario por defecto es un valor <strong><code>1</code></strong>.</td></tr><tr><td><strong><code>cantidad</code></strong></td><td>Int(4)</td><td>Cantidad de unidades compradas.</td></tr><tr><td><strong><code>cantidadRegalo</code></strong></td><td>Int(4)</td><td>Cantidad de unidades para regalo.</td></tr><tr><td><strong><code>precio</code></strong></td><td>Numeric</td><td>Precio unitario de la línea.</td></tr><tr><td><strong><code>descuentos</code></strong></td><td>List&#x3C;<a href="#ordendescuento"><strong>OrdenDescuento</strong></a>> | null</td><td>Lista de descuentos aplicados a cada unidad de la línea.</td></tr><tr><td><strong><code>atributos</code></strong></td><td>Object | null</td><td>Objeto con Claves /Valores con los atributos relevantes del artículo.</td></tr></tbody></table>

## OrdenDescuento

<table data-full-width="false"><thead><tr><th width="260.6666666666667">Clave</th><th width="220">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong><code>nombre</code></strong></td><td>String(32)</td><td>Nombre del descuento.</td></tr><tr><td><strong><code>codigo</code></strong></td><td>String(128)</td><td>Código del descuento.</td></tr><tr><td><strong><code>origen</code></strong></td><td>String</td><td>Origen del descuento, posibles valores: <strong><code>CUPON</code></strong>, <strong><code>PRODUCTO</code></strong>, <strong><code>MEDIO_DE_PAGO</code></strong>, <strong><code>PROMOCION</code></strong>.</td></tr><tr><td><strong><code>monto</code></strong></td><td>Numeric</td><td>Monto del descuento por unidad.</td></tr></tbody></table>

## EventoCallcenter

<table data-full-width="false"><thead><tr><th width="262.6666666666667">Clave</th><th width="221">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong><code>evento</code></strong></td><td>String</td><td>Evento de call center. Los posibles valores son: <strong><code>CREAR</code></strong>, <strong><code>ENVIAR</code></strong>, <strong><code>FINALIZAR</code></strong>.</td></tr><tr><td><strong><code>fecha</code></strong></td><td><a href="/pages/LjX6E6o8pT0EpYonxgLH#datetime"><strong>DateTime</strong></a></td><td>Fecha del evento.</td></tr><tr><td><strong><code>operador</code></strong></td><td><a href="#operadorcallcenter"><strong>OperadorCallCenter</strong></a></td><td>Datos del operador asociado al evento.</td></tr></tbody></table>

## OperadorCallCenter

<table><thead><tr><th width="263.3333333333333">Clave</th><th width="224">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong><code>nombre</code></strong></td><td>String(255)</td><td>Nombre del operador.</td></tr><tr><td><strong><code>apellido</code></strong></td><td>String(255)</td><td>Apellido del operador.</td></tr><tr><td><strong><code>email</code></strong></td><td>String(255)</td><td>Email del operador.</td></tr></tbody></table>

## Comprador

<table data-full-width="false"><thead><tr><th width="246">Clave</th><th width="223">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong><code>id</code></strong></td><td>int(32)</td><td>Identificador del comprador en Fenicio.</td></tr><tr><td><strong><code>codigo</code></strong></td><td>String(16) | null</td><td>Código del usuario.</td></tr><tr><td><strong><code>email</code></strong></td><td>String(255)</td><td>Email del usuario.</td></tr><tr><td><strong><code>nombre</code></strong></td><td>String(255)</td><td>Nombre del usuario.</td></tr><tr><td><strong><code>apellido</code></strong></td><td>String(255) | null</td><td>Apellido del usuario.</td></tr><tr><td><strong><code>telefono</code></strong></td><td>String(255)</td><td>Teléfono del usuario en formato <strong><code>+[CODIGOPAIS][NUMERO]</code></strong>.<br>Ejemplo: <strong><code>+59899123456</code></strong></td></tr><tr><td><strong><code>genero</code></strong></td><td>String | null</td><td>Género del usuario. Valores posibles: <strong><code>M</code></strong>, <strong><code>F</code></strong>.</td></tr><tr><td><strong><code>documento</code></strong></td><td><a href="#documento"><strong>Documento</strong></a> | null</td><td>Datos del documento del usuario.</td></tr><tr><td><strong><code>extras</code></strong></td><td>Object | null</td><td>Clave / Valor de datos extras referidos al usuario. Estos datos extras son configurables por comercio.</td></tr></tbody></table>

## Documento

<table data-full-width="false"><thead><tr><th width="248.66666666666669">Clave</th><th width="225">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong><code>numero</code></strong></td><td>String(32)</td><td>Número de documento.</td></tr><tr><td><strong><code>pais</code></strong></td><td>String(2)</td><td>Código ISO 3166-1 del país.</td></tr><tr><td><strong><code>tipo</code></strong></td><td>String</td><td>Tipo de documento. Valores posibles: <strong><code>PASAPORTE</code></strong>, <strong><code>DOCUMENTO_IDENTIDAD</code></strong>.</td></tr></tbody></table>

## Direccion

<table data-full-width="false"><thead><tr><th width="252.66666666666669">Clave</th><th width="227">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong><code>latitud</code></strong></td><td>Numeric | null</td><td>Latitud.</td></tr><tr><td><strong><code>longitud</code></strong></td><td>Numeric | null</td><td>Longitud.</td></tr><tr><td><strong><code>pais</code></strong></td><td>String(64)</td><td>Nombre del País.</td></tr><tr><td><strong><code>estado</code></strong></td><td>String(255)</td><td>Nombre del estado, provincia o departamento.</td></tr><tr><td><strong><code>localidad</code></strong></td><td>String(255)</td><td>Nombre de la localidad.</td></tr><tr><td><strong><code>calle</code></strong></td><td>String(255)</td><td>Nombre de la calle.</td></tr><tr><td><strong><code>numeroPuerta</code></strong></td><td>String(16)</td><td>Número de puerta.</td></tr><tr><td><strong><code>numeroApto</code></strong></td><td>String(5) | null</td><td>Número de apartamento.</td></tr><tr><td><strong><code>codigoPostal</code></strong></td><td>String(16) | null</td><td>Código postal de la dirección.</td></tr><tr><td><strong><code>observaciones</code></strong></td><td>String(255) | null</td><td>Observaciones extra de la dirección.</td></tr></tbody></table>

## Pago

<table data-full-width="false"><thead><tr><th width="255">Clave</th><th width="226">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong><code>id</code></strong></td><td>Int(32)</td><td>Identificador del pago en Fenicio.</td></tr><tr><td><strong><code>idExterno</code></strong></td><td>String(255) | null</td><td>Identificador externo del medio de pago con el que se realizó.</td></tr><tr><td><strong><code>codigo</code></strong></td><td>String(32)</td><td>Código del medio de pago. Posibles valores: ver <a href="/pages/bFCMH6SrzqJpRyMofeC1"><strong>Medios de pago</strong></a>.</td></tr><tr><td><strong><code>conector</code></strong></td><td>String(32)</td><td>Tipo de conector utilizado para realizar el pago. Posibles valores: ver <a href="/pages/ZsKIqeky4isPapTLM0QW"><strong>Integradores de pago</strong></a>.</td></tr><tr><td><strong><code>estado</code></strong></td><td>String(16)</td><td>Estado del pago en Fenicio. Posibles valores: <strong><code>PENDIENTE</code></strong>, <strong><code>APROBADO</code></strong>, <strong><code>ERROR</code></strong>, <strong><code>CANCELADO</code></strong>, <strong><code>REVERSADO</code></strong>.</td></tr><tr><td><strong><code>fechaVencimiento</code></strong></td><td><a href="/pages/LjX6E6o8pT0EpYonxgLH#datetime"><strong>DateTime</strong></a> | null</td><td>Fecha de vencimiento del pago.</td></tr><tr><td><strong><code>fechaPago</code></strong></td><td><a href="/pages/LjX6E6o8pT0EpYonxgLH#datetime"><strong>DateTime</strong></a> | null</td><td>Fecha de confirmación de pago.</td></tr><tr><td><strong><code>fechaCancelacion</code></strong></td><td><a href="/pages/LjX6E6o8pT0EpYonxgLH#datetime"><strong>DateTime</strong></a> | null</td><td>Fecha de cancelación del pago.</td></tr><tr><td><strong><code>cuotas</code></strong></td><td>Int(2)</td><td>Cantidad de cuotas en la que se realizó el pago.</td></tr><tr><td><strong><code>importe</code></strong></td><td>Numeric</td><td>Importe total del pago.</td></tr><tr><td><strong><code>moneda</code></strong></td><td>String(4)</td><td>Código ISO 4217 de la moneda. Ejemplo: <strong><code>UYU</code></strong>.</td></tr><tr><td><strong><code>bin</code></strong></td><td>String(6) | null</td><td>Primeros 6 dígitos de la tarjeta de pago.</td></tr><tr><td><strong><code>autorizacion</code></strong></td><td>String(128) | null</td><td>Código de autorización enviado por el medio de pago.</td></tr><tr><td><strong><code>numeroTarjeta</code></strong></td><td>String(128) | null</td><td>Número de tarjeta de pago (enmascarado).</td></tr><tr><td><strong><code>terminacionTarjeta</code></strong></td><td>String(4) | null</td><td>Últimos 4 dígitos de la tarjeta de pago.</td></tr></tbody></table>

## Entrega

<table data-full-width="false"><thead><tr><th width="243">Clave</th><th width="224">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong><code>tipo</code></strong></td><td><a href="/pages/LjX6E6o8pT0EpYonxgLH#tipoentrega"><strong>TipoEntrega</strong></a> | null</td><td>Tipo de entrega para la orden. Posibles valores: <code>RETIRO</code>, <code>ENVIO</code>.</td></tr><tr><td><strong><code>estado</code></strong></td><td><a href="/pages/LjX6E6o8pT0EpYonxgLH#estadoentrega"><strong>EstadoEntrega</strong></a> | null</td><td>Estado de la entrega de la orden.</td></tr><tr><td><strong><code>horario</code></strong></td><td><a href="/pages/KDtLV7QEXilKBMRN9Piy#franjaentrega"><strong>FranjaEntrega</strong></a> | null</td><td>Franja de horario en el que se entrega la orden.</td></tr><tr><td><strong><code>destinatario</code></strong></td><td>String(255) | null</td><td>Persona que recibirá la orden.</td></tr><tr><td><strong><code>direccionEnvio</code></strong></td><td><a href="#direccion"><strong>Direccion</strong></a> | null</td><td>Dirección de entrega.</td></tr><tr><td><strong><code>local</code></strong></td><td>object | null</td><td>Información del local asociado.</td></tr><tr><td><strong><code>servicioEntrega</code></strong></td><td><a href="#servicioentrega"><strong>ServicioEntrega</strong></a> | null</td><td>Servicio de entrega.</td></tr><tr><td><strong><code>codigoTracking</code></strong></td><td>String(128) | null</td><td>Código de seguimiento.</td></tr><tr><td><strong><code>etiqueta</code></strong></td><td>String(255) | null</td><td>URL del archivo de la etiqueta para adjuntar al pedido generada por el servicio encargado de la entrega.</td></tr></tbody></table>

## FranjaEntrega

<table><thead><tr><th width="266.3333333333333">Clave</th><th width="219">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong><code>desde</code></strong></td><td><a href="/pages/LjX6E6o8pT0EpYonxgLH#datetime"><strong>DateTime</strong></a></td><td>Fecha y hora de inicio de la franja de entrega.</td></tr><tr><td><strong><code>hasta</code></strong></td><td><a href="/pages/LjX6E6o8pT0EpYonxgLH#datetime"><strong>DateTime</strong></a></td><td>Fecha y hora de fin de la franja de entrega.</td></tr></tbody></table>

**Nota:** las franjas de entrega deben comenzar y terminar dentro del mismo día calendario.

## ServicioEntrega

<table data-full-width="false"><thead><tr><th width="250.66666666666669">Clave</th><th width="223">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong><code>id</code></strong></td><td>Int(32)</td><td>Identificador del servicio de entrega en Fenicio.</td></tr><tr><td><strong><code>codigo</code></strong></td><td>String(64) | null</td><td>Código del servicio de entrega.</td></tr><tr><td><strong><code>nombre</code></strong></td><td>String(64)</td><td>Nombre del servicio de entrega.</td></tr></tbody></table>

## OrdenLinea

<table data-full-width="false"><thead><tr><th width="219.22212727864581">Clave</th><th width="255.666748046875">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong><code>nombre</code></strong></td><td>String(255)</td><td>Nombre descriptivo del artículo en la línea de la orden.</td></tr><tr><td><strong><code>sku</code></strong></td><td>String(128)</td><td>Código único del artículo en el sistema externo o del comercio.</td></tr><tr><td><strong><code>cantidad</code></strong></td><td>Int(4)</td><td>Cantidad de unidades compradas.</td></tr><tr><td><strong><code>cantidadRegalo</code></strong></td><td>Int(4)</td><td>Cantidad de unidades para regalo.</td></tr><tr><td><strong><code>codigoPrecio</code></strong></td><td>String(16)</td><td>Código del tipo de precio aplicado al artículo. Por defecto: 1.</td></tr><tr><td><strong><code>precio</code></strong></td><td>Numeric</td><td>Precio unitario de la línea.</td></tr><tr><td><strong><code>descuentos</code></strong></td><td>List&#x3C;<a href="#ordendescuento"><strong>OrdenDescuento</strong></a>> | null</td><td>Lista de descuentos aplicados a cada unidad de la línea.</td></tr><tr><td><strong><code>atributos</code></strong></td><td>Object | null</td><td>Objeto con Claves /Valores con los atributos relevantes del artículo.</td></tr></tbody></table>

## OrdenDescuento

<table data-full-width="false"><thead><tr><th width="260.6666666666667">Clave</th><th width="220">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong><code>nombre</code></strong></td><td>String(32)</td><td>Nombre descriptivo del descuento.</td></tr><tr><td><strong><code>codigo</code></strong></td><td>String(128)</td><td>Código identificador del descuento.</td></tr><tr><td><strong><code>origen</code></strong></td><td><a href="/pages/LjX6E6o8pT0EpYonxgLH#origendescuento"><strong>OrigenDescuento</strong></a></td><td>Origen del descuento.</td></tr><tr><td><strong><code>monto</code></strong></td><td>Numeric</td><td>Monto del descuento aplicado a la unidad del artículo.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guia.fenicio.help/developers/referencia/modelos-de-datos/integraciones.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.