API VENDE TU JOYA

Esta api permite actualizar el estado, tienda, quilate, precio gramo, gramo y total de una cotización generada en vende tu joya.

Nota

Se debe configurar los permisos necesarios para que el usuario pueda acceder al api

DOMINIOS

Pruebas

https://pruebas.api.vendetujoya.orocash.ec

Producción

http://api.vendetujoya.orocash.ec

TOKEN

Con el usuario y contraseña puede obtener el token de validación.

POST **dominio**/api/token

Respuestas

Código

Descripción

200

Devuelve el token generado.

Ejemplo

>>> curl -d "username=<usuario>&password=<contraseña>" **dominio**/api/token

CÓDIGOS

Retorna el codigo, porcentaje, fecha, estado de los códigos.

GET **dominio**/api/codigo/AN30Q415

Permiso

  • Ver código

Respuestas

Código

Descripción

200

Información del código.

400

Datos no encontrados.

404

No tiene permiso.

Ejemplo

import requests

if __name__ == '__main__':
    url = '**dominio**/api/codigo/26AS52AS'
    headers = {
        'Content-Type': 'application/json',
        'Authorization': 'Token f8b211ae547d8522973d25056787b6de2eac6a0f'
    }
    response = requests.get(url, headers=headers)
    print(response.text.encode('utf8'))

TIENDAS

Retorna el código y descripción de las tiendas.

GET **dominio**/api/tiendas

Permiso

  • Ver tienda

Respuestas

Código

Descripción

200

Información de las tiendas.

400

Datos no encontrados.

404

No tiene permiso.

Ejemplo

import requests

if __name__ == '__main__':
    url = '**dominio**/api/tiendas'
    headers = {
        'Content-Type': 'application/json',
        'Authorization': 'Token f8b211ae547d8522973d25056787b6de2eac6a0f'
    }
    response = requests.get(url, headers=headers)
    print(response.text.encode('utf8'))

QUILATES

Retorna el código y descripción de las tiendas.

GET **dominio**/api/quilates

Permiso

  • Ver estructura mercadería

Respuestas

Código

Descripción

200

Información de los quilates existentes.

400

Datos no encontrados.

404

No tiene permiso.

Ejemplo

import requests

if __name__ == '__main__':
    url = '**dominio**/api/quilates'
    headers = {
        'Content-Type': 'application/json',
        'Authorization': 'Token f8b211ae547d8522973d25056787b6de2eac6a0f'
    }
    response = requests.get(url, headers=headers)
    print(response.text.encode('utf8'))

COTIZACIONES

Consultar

Se puede consultar una cotización por código devolviendo la información correspondiente.

GET **dominio**/api/cotizacion/AN30Q415

Permiso

  • Ver cotización

  • Ver código

Respuestas

Código

Descripción

200

Información de la cotización.

404

Datos no encontrados.

401

No tiene permiso.

Ejemplo

import requests

if __name__ == '__main__':
    url = '**dominio**/api/cotizacion/26AS52AS'
    headers = {
        'Content-Type': 'application/json',
        'Authorization': 'Token f8b211ae547d8522973d25056787b6de2eac6a0f'
    }
    response = requests.get(url, headers=headers)
    print(response.text.encode('utf8'))

Modificar

Este método permite actualizar diferentes campos como por ejemplo:

  • Tienda.

  • Estado del producto.

  • Quilates.

  • Gramos.

  • Precio gramo.

  • Total.

  • Estado (cotización y código).

  • Descripción

  • Marca

  • Modelo

  • Numero Modelo

PATCH **dominio**/api/cotizacion/AN30Q415

Permiso

  • Cambiar cotización

  • Cambiar código

Respuestas

Código

Descripción

200

Datos modificados correctamente.

400

Datos no encontrados.

404

No tiene permiso.

Ejemplo

{
            "tienda_compradora": codigo Tienda (String),
            "numero_contratacion": String,
            "raw" : Arreglo de objetos
            [
                {
                    "id_tipo_producto":TipoProducto (numerico),
                    "peso":numerico o decimal,
                    "descripcion":String,
                    "id_quilates":Quilates (numerico),
                    "precio_gramo_contratado": numerico o decimal,
                    "estado_producto":EstadoProducto (numerico),
                    "precio_contratacion": numerico o decimal,
                    "id_marca":Marca (numerico),
                    "modelo":String,
                    "numero_modelo":String

                }
            ]
}
import requests

if __name__ == '__main__':
    url = "**dominio**/api/cotizacion/26AS52AS"
    payload = "{\"tienda_compradora\": 1,\"numero_contratacion\":\"0000-000-1\",\"raw\":[{\"id_tipo_producto\":1,\"peso\":2,\"descripcion\":\"JOYA 1\",\"id_quilates\":6,\"precio_gramo_contratado\": 20.0,\"estado_producto\":1,\"precio_contratacion\": 20.0}]}"
    headers = {
        'authorization': "Token f8b211ae547d8522973d25056787b6de2eac6a0f",
        'content-type': "application/json",
        'cache-control': "no-cache",
        'postman-token': "5094bb07-8f29-f01d-c870-538360c48bd2"
        }
    response = requests.request("PATCH", url, data=payload, headers=headers)
    print(response.text)

DETALLE DE LAS COTIZACIONES

EDITAR

Se puede consultar los detalles de cotización por el id del detalle de cotizacion devolviendo la información correspondiente.

PUT **dominio**/api/detalle-cotizacion/1

Permiso

  • Editar detalle cotizacion

Respuestas

Código

Descripción

200

Datos Actualizados.

404

Datos no encontrados.

401

No tiene permiso.

Ejemplo

import requests

if __name__ == '__main__':
    url = "**dominio**/api/cotizacion/26AS52AS"
    payload = "{\"id_tipo_producto\":1,\"peso\":23,\"id_quilates\":2,\"precio_contratacion\":23,\"id_cotizacion\":2,\"estado_producto\":1}"
    headers = {
        'authorization': "Token f8b211ae547d8522973d25056787b6de2eac6a0f",
        'content-type': "application/json",
        'cache-control': "no-cache",
        'postman-token': "5094bb07-8f29-f01d-c870-538360c48bd2"
        }
    response = requests.request("PATCH", url, data=payload, headers=headers)
    print(response.text)    print(response.text.encode('utf8'))

TIPOS DE PRODUCTOS

CONSULTAR

Se puede consultar los tipos de productos

GET **dominio**/api/tipos-productos

Permiso

  • Consultar tipos de productos

Respuestas

Código

Descripción

200

Datos de los tipos de productos

404

Datos no encontrados.

401

No tiene permiso.

Ejemplo

url = "http://192.168.1.105:8000/api/tipos-productos/"

payload={}
headers = {
'Authorization': 'Token 0af4ac1faa445fc02971f713e334fb425be0cc2b'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

ESTADOS PRODUCTOS

Retorna los estados de los productos.

GET **dominio**/api/estados-productos

Permiso

  • Ver estados productos

Respuestas

Código

Descripción

200

Información de los estados de productos existentes.

401

No tiene permisos

404

Datos no encontrados

Ejemplo

url = "http://192.168.1.105:8000/api/estados-productos/"

payload={}
headers = {
'Authorization': 'Token 0af4ac1faa445fc02971f713e334fb425be0cc2b'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

GENERAR NUEVO CODIGO

Retorna los estados de los productos.

POST **dominio**/api/nuevo-codigo/9AN10G277N

Permiso

  • Ver estados productos

Respuestas

Código

Descripción

200

Nuevo codigo

401

No tiene perimos

404

Datos no encontrados

Ejemplo

url = "http://192.168.1.105:8000/api/nuevo-codigo/1AN10G487R"

payload={}
headers = {
'Authorization': 'Token 0af4ac1faa445fc02971f713e334fb425be0cc2b'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

MARCAS

Retorna la información de las Marcas.

GET **dominio**/api/marcas/

Permiso

  • Ver Marcas

Respuestas

Código

Descripción

200

Información de las marcas existentes.

400

Datos no encontrados.

404

No tiene permiso.

Ejemplo

import requests

if __name__ == '__main__':
    url = '**dominio**/api/marcas/'
    headers = {
        'Content-Type': 'application/json',
        'Authorization': 'Token f8b211ae547d8522973d25056787b6de2eac6a0f'
    }
    response = requests.get(url, headers=headers)
    print(response.text.encode('utf8'))