RECURSOS

Order
El recurso ORDER contiene toda la información de una venta.

OPERACIÓN MÉTODO URL

Detalle de venta x por
GET https://api.mitienda.pe/v1/mitienda/order/{id}
ID
Detalle de venta por https://api.mitienda.pe/v1/mitienda/order?
GET
Código de venta code={codigoventa}

OBJETO ORDER
{
"id": "40909",
"status": "1",
"status_detail": "aprobado",
"date_created": "2020-04-07 23:56:52",
"receive_type": "shipping",
"date_payment": "2020-04-07 23:58:19",
"code": "CQ8371P1PZ",
"note": "Cuando lleguen con el Pedido x favor llamar ",
"order_items": [
{
"id": "114689",
"sku": "0237",
"title": "QUESO LAIVE EDAM EN TAJADAS",
"variation_attributes": {
"id":"0237-1",
"attribute":"Paquete 500G",
},
"discount": {
"discount_type": {
"type":"p",
"discount_mode":"p",
"discount_value":"10",
"discount_cupon":"QUESO10",
},
 "discount_amount":"2.17",
},
"quantity": "1",
"unit_price": "21.70",
"currency_id": "PEN"
},
{
"id": "114767",
"sku": "0610",
"title": "YOGURT PROBIOTICO LAIVE DURAZNO GALONERA 1.8KG",
"variation_attributes": null,
"discount": null,
"quantity": "1",
"unit_price": "9.50",
"currency_id": "PEN"
},
{
"id": "114770",
"sku": "0611",
"title": "YOGURT PROBIOTICO LAIVE FRESA GALONERA 1.8KG",
"variation_attributes": null,
"discount": null,
"quantity": "1",
"unit_price": "9.50",
"currency_id": "PEN"
},
{
"id": "114697",
"sku": "0550",
"title": " MANTEQUILLA CON SAL LAIVE BARRA 200G",
"variation_attributes": null,
"discount": null,
"quantity": "2",
"unit_price": "8.50",
"currency_id": "PEN"
},
{
"id": "114772",
"sku": "2131",
"title": "LECHE LIGHT LAIVE BOLSA 900ML",
"variation_attributes": null,
"discount": null,
"quantity": "8",
 "unit_price": "3.60",
"currency_id": "PEN"
}
],
"discount": [],
"total_amount": "86.50",
"payment_gateway_id": "7",
"payment_gateway": "CULQI",
"payment_method": "credito",
"currency_id": "PEN",
"billing_info": {
"name": "Manuel Fernando Giuliano",
"last_name": "Silva Moncayo",
"email": "mfsilvam@pucp.pe",
"phone_number": "989828299",
"billing_address": {
"address_line": "Jr Cusco 350 Dpto 105",
"city": {
"id": "1",
"name": "LIMA"
},
"state": {
"id": "15",
"name": "LIMA"
},
"country": {
"id": "1",
"name": "PERÚ"
},
"distric": {
"id": "20",
"name": "MAGDALENA DEL MAR"
}
},
"doc_type": "RUC",
"doc_number": "20603367058",
"business_name": "Social Solutions",
"e-billing": {
"id":"2",
"name":"NUBEFACT",
"logo":"https://mitienda.pe/_/img/NubeFact.png",
"billing_date":"2020-04-07",
"serie":"F001",
 "correlative":"00000028",
"url_pdf":"https://mitienda.pe/tufactura_F001-00000028.pdf",
},
"shipping": {
"status": "pendiente",
"date_delivered": null,
"receiver_address": {
"address_line": "Jr. Cusco 456, Magdalena del Mar, Perú",
"address_line2": "interior 2 ",
"zip_code": "10260",
"city": {
"id": "1",
"name": "LIMA"
},
"state": {
"id": "15",
"name": "LIMA"
},
"country": {
"id": "1",
"name": "PERÚ"
},
"distric": {
"id": "20",
"name": "MAGDALENA DEL MAR"
},
"latitude": "-9.189967",
"longitude": "-75.015152",
"comment": null
},
"cost": "0.00",
"courier": {
"id":"2",
"name":"Globo",
"url_logo":"https://mitienda.pe/_/img/miTienda.png"
}
},
"pickup_store": null
}
ATRIBUTOS
Parámetro Tipo Descripción
id INTEGE Id de la venta
R
status INTEGE Estado de la venta en número
R (0=>rechazado;1=>aprobado;2=>pendiente;12=>expira
do)
status_detail STRING Estado de la venta en texto
(rechazado; aprobado; pendiente; expirado)
date_created DATE Fecha de creación de la venta.
TIME
date_payment DATE Fecha de pago de la venta.
TIME
code STRING Código de referencia de la venta
note STRING Nota del cliente durante la venta
order_items ARRAY Productos de la venta
-> ítem OBJECT Datos del producto
-> -> id INTEGE Id del producto
R
-> -> sku STRING Sku del producto
-> -> title STRING Título del producto
-> -> OBJECT Variación del producto
variation_attributes
-> -> -> id INTEGE Id del atributo
R
-> -> -> attribute STRING Nombre del atributo del producto
-> -> quantity INTEGE Cantidad comprada del producto
R
-> -> discount OBJECT Descuento del producto
-> -> -> OBJECT Datos sobre el tipo de descuento
discount_type
-> -> ->-> type INTEGE Id del tipo de descuento
R
-> -> ->-> STRING P=>PORCENTAJE, V=>VALOR

discount_mode
-> -> ->-> FLOAT Valor del descuento en porcentaje o
discount_value valor.
-> -> ->-> STRING Código del cupón (si fuera cupón)
discount_cupon
-> -> -> FLOAT Monto total del descuento
discount_amount
-> -> unit_price FLOAT Precio unitario del producto
-> -> currency_id STRING Moneda
(PEN=>SOLES, USD=>DOLARES)
discount OBJECT Datos de descuento.
-> discount_type OBJECT Datos del tipo de descuento
-> -> type STRING Identificador del tipo de descuento
-> -> discount_mode STRING P=>PORCENTAJE, V=>VALOR

-> -> discount_value FLOAT Valor del descuento en porcentaje o

valor.
-> -> STRING Código del cupón (si fuera cupón)
discount_cupon
-> -> discount_name STRING Nombre del descuento
->discount_amount FLOAT Monto total de los decuentos
payment_gateway_i INT Id del método de pago
d
total_amount FLOAT Monto total de los ítems del carrito
payment_gateway STRING Pasarela de pago utilizada para la venta
payment_method STRING Método de pago
(Efectivo, Deposito o transferencia, debito, crédito)
currency_id STRING Moneda
(PEN=>SOLES, USD=>DOLARES)
billing_info OBJECT Datos de facturación
-> name STRING Nombre del comprador
-> last_name STRING Apellidos del comprador
-> email STRING Correo del comprador
-> phone_number STRING Número de teléfono del comprador
-> billing_address OBJECT Datos de la dirección de facturación
-> -> address_line STRING Primera línea de dirección
-> -> city OBJECT Datos de la ciudad
-> -> ->id INTEGE Id de la ciudad
R
-> -> -> name INTEGE Nombre de la ciudad
 R
-> -> state OBJECT Datos del estado o provincia
-> -> ->id INTEGE Id del estado o provincia
R
-> -> -> name INTEGE Nombre del estado o provincia
R
-> -> country OBJECT Datos del país
-> -> ->id INTEGE Id del país
R
-> -> -> name INTEGE Nombre del país
R
-> -> distric OBJECT Datos del distrito
-> -> ->id INTEGE Id del distrito
R
-> -> -> name INTEGE Nombre del distrito
R
-> doc_id INT Id del documento
9=>Documento, 1=>DNI, 2=>RUC,
3=>Pasaporte,4=>Carnet de extranjería
-> doc_type STRING Nombre del documento.
-> doc_number STRING Número del documento
-> business_name STRING Razón social de la empresa
-> e-billing OBJECT Datos sobre facturación electrónica
-> -> id INTEGE Id de la empresa de facturación
R
-> -> name STRING Nombre de la empresa de facturacón
-> -> logo STRING Url del logo de la empresa de
facturación
-> -> status INTEGE 0=>Rechazado, 1=>ACEPTADO, 2=>Pendiente

R
-> -> billing_date DATE Fecha de emisión del documento
-> -> serie STRING Serie del documento
-> -> correlative STRING Numero correlativo del documento
-> -> url_pdf STRING Url del comprobante del documento
emitido en formato pdf
shipping OBJECT Datos de envío
-> status STRING Estado del envío
(pendiente, rechazado, enviado)
-> doc_id INT Id del documento
9=>Documento, 1=>DNI, 2=>RUC,
3=>Pasaporte,4=>Carnet de extranjería
-> doc_type STRING Nombre del documento.
-> doc_number STRING Número del documento
-> date_delivered DATE Fecha de envió
-> receiver_address OBJECT Dirección de envío
-> -> address_line STRING Dirección
-> ->address_line2 STRING Segunda línea de dirección
-> -> zip_code STRING Código zip de la dirección
-> -> city OBJECT Datos de la ciudad
-> -> -> id INTEGE Id de la ciudad
R
-> -> -> name STRING Nombre de la ciudad
-> -> state OBJECT Datos del estado
-> -> -> id INTEGE Id del estado
R
-> -> -> name STRING Nombre del estado
-> -> country OBJECT Datos del país
-> -> -> id INTEGE Id del país
R
-> -> -> name STRING Nombre del país
-> -> distric OBJECT Datos del distrito
-> -> -> id INTEGE Id del distrito
R
-> -> -> name STRING Nombre del distrito
-> -> latitude STRING Latitud de la dirección
-> -> longitude STRING Longitud de la dirección
-> -> comment STRING Comentario acerca del envío
-> cost FLOAT Monto de envío
-> courier OBJECT Datos del courier
-> -> id INTEGE Id del Courier
R
-> -> name STRING Nombre del Courier
-> -> url_logo STRING Url del logo del corrier
-> url_traking STRING Url para seguimiento del envío.
pickup_store OBJECT
-> status STRING Estado de recojo de productos
 (pendiente, rechazado, enviado)
-> receiver_address OBJECT Dirección de recojo
-> -> address_line STRING Dirección
-> -> city OBJECT Datos de la ciudad
-> -> -> id INTEGE Id de la ciudad
R
-> -> -> name STRING Nombre de la ciudad
-> -> state OBJECT Datos del estado
-> -> -> id INTEGE Id del estado
R
-> -> -> name STRING Nombre del estado
-> -> country OBJECT Datos del País
-> -> -> id INTEGE Id del país
R
-> -> -> name STRING Nombre del país
-> -> distric OBJECT Datos del Distrito
-> -> -> id INTEGE Id del distrito
R
-> -> -> name STRING Nombre del distrito
-> -> latitude STRING Latitud de la dirección
-> -> longitude STRING Longitud de la dirección
-> -> comment STRING Comentario acerca del recojo

Detalle de venta x por ID

 GET https://api.mitienda.pe/v1/mitienda/order/{id}

PETICIÓN:
HEADER

Content-Type : application/json

token : <<token>>

BODY

{}

ATRIBUTOS:
Id : ID de la venta a consultar

RESPUESTA:

200 OK

Detalle de venta por Código de venta

GET https://api.mitienda.pe/v1/mitienda/order?code={codigoventa}

PETICIÓN:
HEADER

Content-Type : application/json

token : <<token>>

BODY

{}

ATRIBUTOS:
code : Código de referencia de la venta a consultar

RESPUESTA:

200 OK

Product
El recurso PRODUCT contiene toda la información de un producto

OPERACIÓN MÉTODO URL

Consultar Producto GET https://api.mitienda.pe/v1/mitienda/product/{id}
Modificar Stock de
PUT https://api.mitienda.pe/v1/mitienda/product/{id}
producto
Modificar Stock de https://api.mitienda.pe/v1/mitienda/product/
PUT
variante de producto {id_product}/variants/{id_variant}

OBJETO PRODUCT
{
    "id": "114689",
    "sku": "0237",
    "name": "QUESO LAIVE EDAM EN TAJADAS PQTE 500G",
    "name_url": "queso-laive-edam-sandwich-s-i-paquete-500g",
    "url": "https://ico.com.pe/producto/queso-laive-edam-sandwich-s-i-paquete-
500g",
    "published": true,
    "created_at": "2020-03-23 14:48:31",
    "updated_at": "2020-04-06 23:04:37",
    "kind_of_item": "1",
    "shipping_conversion_factor": "1.00",
    "price": "21.70",
    "stock": "0",
    "unlimited_stock": false,
    "description": "<p>Un sandwich es más delicioso con queso Edam Laive</p>",
    "has_variation_attributes ": false,
    "variation_attributes": [],
    "seo": {
        "meta_tittle": "",
        "meta_description": ""
    },
    "brand": {
        "id": "",
        "name": "",
        "url": ""
    }
}

ATRIBUTOS
Parámetro Tipo Descripción
id INTEGER Id del producto
sku STRING Código de identificación
name STRING Nombre del ítem
name_url STRING Nombre del ítem en formato
URL
url STRING URL del producto en la tienda
published BOOLEAN Producto es visible en el
catálogo
created_at DATE TIME Fecha de creación del
producto
updated_at DATE TIME Fecha de actualización del
producto
kind_of_item INTEGER Tipo de Producto
(1=>Producto, 2=>Servicio)
shipping_conversion_factor INTEGER Factor de conversión usado
para el cálculo del envío
price FLOAT Precio del producto
stock INTEGER Stock del producto
unlimited_stock BOOLEAN Producto tiene stock ilimitado
description TEXT Descripción del producto
has_variation_attributes BOOLEAN Producto tiene variantes
variation_attributes OBJECT Variantes del Producto
-> id INTEGER Id de la variante
-> name STRING Nombre de la variante
-> price FLOAT Precio de la variante
-> stock INTEGER Stock de la variante
-> unlimited_stock BOOLEAN Variante tiene stock ilimitado
seo OBJECT Datos de SEO del producto
-> meta_tittle STRING Meta título del producto
-> meta_description STRING Meta descripción del producto
brand OBJECT Marca del producto
-> id INTEGER Id de la marca
-> name STRING Nombre de la marca
-> url STRING URL en el catálogo de la marca
Consultar Producto
GET https://api.mitienda.pe/v1/mitienda/product/{id}

PETICIÓN:
HEADER

Content-Type : application/json

token : <<token>>

BODY

{}

ATRIBUTOS:
Id : ID del producto a consultar

RESPUESTA:

200 OK

Modificar Stock de Producto

PUT https://api.mitienda.pe/v1/mitienda/product/{id}

PETICIÓN:
HEADER

Content-Type : application/json

token : <<token>>

BODY

"stock": 25

}
ATRIBUTOS:
id : ID del producto a actualizar

stock : Nuevo stock a actualizar

RESPUESTA:

200 OK

Modificar Stock de variante de producto

PUT https://api.mitienda.pe/v1/mitienda/product/{id_product}/variants/{id_variant}

PETICIÓN:
HEADER

Content-Type : application/json

token : <<token>>

BODY

"stock": 12

ATRIBUTOS:
id_product : ID del producto a actualizar

id_variant : ID de la variante del producto a actualizar

stock : Nuevo stock a actualizar

RESPUESTA:

200 OK
NOTA: Si un producto tiene variantes, solo se podrá modificar el stock de una de las variantes, no aplica al
producto.