Crear un pedido

Crear un nuevo pedido consta de 3 pasos
1. Crear el cliente
2. Crear el envio
3. Crear la orden de venta

Crear cliente

POST /clientes

Contenido del JSON a enviar

Personas fisicas

Campo	Descripción
`persona`	Defecto: fisica
`tipo`	Defecto: minorista
`nombre`	Nombre del cliente
`apellido`	Apellido del cliente
`documento`	DNI del cliente
`cuit`	CUIT del cliente
`condicion_iva`	4: Cons.Final - 1: Resp. Incripto
`calle`	Dirección fiscal
`numero`	Dirección fiscal
`departamento`	Dirección fiscal
`piso`	Dirección fiscal
`localidad`	Dirección fiscal
`codigo_postal`	Dirección fiscal
`provincia`	Dirección fiscal
`telefono`	Telefono
`celular`	Celular
`email`	Email

Personas juridicas (empresas)

Campo	Descripción
`persona`	juridica
`tipo`	Defecto: minorista
`razon_social`	Razon social del cliente
`cuit`	CUIT del cliente
`condicion_iva`	1: Resp. Incripto
`calle`	Dirección fiscal
`numero`	Dirección fiscal
`departamento`	Dirección fiscal
`piso`	Dirección fiscal
`localidad`	Dirección fiscal
`codigo_postal`	Dirección fiscal
`provincia`	Dirección fiscal
`telefono`	Telefono
`celular`	Celular
`email`	Email

Ejemplos

Ejemplo persona fisica

    POST https://api.jarseindustrial.com/clientes
    Content-Type: application/json

    {
            "persona": "fisica",
            "tipo": "minorista",
            "nombre": "Carlos",
            "apellido": "Ejemplo",
            "documento": "123456789",
            "condicion_iva": 4,
            "calle": "Ejemplo",
            "numero": "1234",
            "departamento": "10",
            "piso": "C",
            "localidad": "CABA",
            "codigo_postal": "1078",
            "provincia": "CABA",
            "pais": "ARGENTINA",
            "telefono": "011-123456789",
            "celular": "011-15-123456789",
            "email": "ejemplo@ejemplo.com"
        }

Ejemplo empresas

    POST https://api.jarseindustrial.com/clientes
    Content-Type: application/json

    {
            "persona": "juridica",
            "tipo": "minorista",
            "razon_social": "Ejemplo SRL",
            "cuit": "301234567897",
            "condicion_iva": 1,
            "calle": "Ejemplo",
            "numero": "1234",
            "departamento": "10",
            "piso": "C",
            "localidad": "CABA",
            "codigo_postal": "1078",
            "provincia": "CABA",
            "pais": "ARGENTINA",
            "telefono": "011-123456789",
            "celular": "011-15-123456789",
            "email": "compras@ejemplosrl.com"
        }

Ejemplo respuesta

Del JSON devuelto en la creación, debemos extraer el id del nuevo cliente para usarlo al crear la orden de venta.


Status: 200 OK

{
    "id": 505503,
    "persona": "fisica",
    "tipo": "minorista",
    "nombre": "Carlos",
    "apellido": "Ejemplo",
    "tipo_documento": "DNI",
    "documento": "123456789",
    "condicion_iva": 4,
    "factura_en_dolares": "N",
    "ofertas_desactivadas": "N",
    "respeta_precio_pactado": "N",
    "bonificaciones_desactivadas": "N",
    "logistica_predeterminada": null,
    "logistica_secundaria": null,
    "distancia": null,
    "calle": "Ejemplo",
    "numero": "1234",
    "departamento": "10",
    "piso": "C",
    "localidad": "CABA",
    "codigo_postal": "1078",
    "codigo_provincia": "C",
    "provincia": "CABA",
    "pais": "ARGENTINA",
    "telefono": "011-123456789",
    "celular": "011-15-123456789",
    "email": "ejemplo@ejemplo.com",
    "email_alternativo": null,
}

Crear envío

POST /envios

Contenido del JSON a enviar

Campo	Descripción
`id_externa`	Campo opcional para agregar su ID de remito.
`plataforma`	Plataforma de logistica (Siempre `propia`)
`tipo`	Tipo de envio
`empresa_logistica`	Id de la empresa de logistiva
`importe`	Importe a incluir en la factura
`importe_cliente`	Importe pagado por el cliente (no se incluye en la factura)
`codigo_retiro`	Codigo de retiro
`codigo_qr`	Token de retiro (MD5 o SHA)
`tracking_codigo`	Número de tracking
`recibe`	Nombre de quien recibe o retira
`documento`	Documento de quien recibe o retira
`calle`	Dirección de envío
`numero`	Dirección de envío
`departamento`	Dirección de envío
`piso`	Dirección de envío
`comentario`	Dirección de envío
`entre_calles`	Dirección de envío
`localidad`	Dirección de envío
`codigo_postal`	Dirección de envío
`provincia`	Dirección de envío
`telefono`	Teléfono de quien retira
`celular`	Celular de quien retira
`email`	Email de quien retira

Plataformas y tipos de envio

El campo plataforma debe ser siempre propia
Ver todos los tipos de envio aquí

Empresas de logistica

Ver los codigos de transportes mas usados aquí

Ejemplo


{
        "plataforma": "propia",
        "tipo": "plataforma",
        "empresa_logistica": "C05",
        "importe": 0,
        "importe_cliente": 0,
        "codigo_retiro": "",
        "codigo_qr": "",
        "tracking_codigo": "AV468447782379DZA",
        "recibe": "Pedro Ejemplo",
        "documento": "123456789",
        "calle": "Ejemplo",
        "numero": "1234",
        "departamento": "10",
        "piso": "C",
        "comentario": "Timbre roto",
        "entre_calles": "Pruebas y Av Test",
        "localidad": "BUENOS AIRES",
        "codigo_postal": "1100",
        "provincia": "CABA",
        "telefono": "011-123456798",
        "celular": "011-15-123456798",
        "email": "pedro@ejemplo.com"
    }

Ejemplo respuesta

Del JSON devuelto en la creación, debemos extraer el id del envio para usarlo al crear la orden de venta.


Status: 200 OK

{
    "id": 10490,
    "id_externa": null,
    "cuenta": null,
    "plataforma": "propia",
    "tipo": "plataforma",
    "estado": null,
    "estado_plataforma": null,
    "empresa_logistica": {
        "codigo": "C05",
        "descripcion": "CORREO ARGENTINO",
        "telefono": "4891-9191",
        "direccion": "CASEROS 2459 Y JUJUY",
        "localidad": "PARQUE PATRICIOS",
        "provincia": "BUENOS AIRES",
        "codigo_postal": 0,
        "created_at": "2020-01-14T16:42:39.000Z",
        "updated_at": "2020-01-14T16:42:39.000Z"
    },
    "numero_guia": null,
    "importe": 0,
    "importe_base": 0,
    "importe_bonificado": 0,
    "descuento": 0,
    "codigo_retiro": "",
    "codigo_qr": "",
    "importe_cliente": 0,
    "tracking_codigo": "AV468447782379DZA",
    "tracking_retorno_codigo": null,
    "tracking_metodo": null,
    "observacion": null,
    "recibe": "Pedro Ejemplo",
    "documento": "123456789",
    "horario_desde": null,
    "horario_hasta": null,
    "calle": "Ejemplo",
    "numero": "1234",
    "departamento": "10",
    "piso": "C",
    "comentario": "Timbre roto",
    "entre_calles": "Pruebas y Av Test",
    "barrio": null,
    "localidad": "BUENOS AIRES",
    "codigo_postal": "1100",
    "provincia": "CABA",
    "pais": null,
    "latitud": null,
    "longitud": null,
    "telefono": "011-123456798",
    "celular": "011-15-123456798",
    "email": "pedro@ejemplo.com",
    "etiqueta": null,
    "created_at": "2020-08-23T02:39:13.000Z",
    "updated_at": "2020-08-23T02:39:13.000Z",
    "created_user": null,
    "updated_user": null,
    "codigo_provincia": "C"
}

Crear orden de venta

POST /pedidos

Contenido del JSON a enviar

Objeto pedido

Campo	Descripción
`id_externa`	Id de la venta en su plataforma
`cliente`	Id o JSON del cliente
`envio`	Id o JSON del envio
`moneda`	Defecto: ARS
`cotizacion`	Defecto: 1
`items`	Array de objetos items
`pagos`	Array de objetos pagos

Objeto items

Campo	Descripción
`id_externa`	Id de la publicacion en su plataforma
`codigo`	Codigo del producto (Ej. 22715/7)
`cantidad`	Cantidad
`alicuota_iva`	Defecto: 0.21
`precio_unitario_neto`	Precio unitario del item neto de IVA
`descuento`	% de descuento aplicado. Es un campo informativo

Precios

Los precios enviados siempre seran netos de IVA e impuestos internos.
La alicuota de IVA es opcional (por defecto 0.21). En todo caso se envia en decimal
En todos los casos el descuento solo se debe incluir a modo informativo para la facturación. Todo calculo de formulas de descuento deberá ser aplicado en su plataforma

Objeto pagos

Campo	Descripción
`id_externa`	Id del pago en su plataforma
`plataforma`	mercadopago o decidir

Autorización

Recordar que se controla la acreditación de los pagos en todos los casos.
No se permite despachar pedidos que no este cubiertos por sus respectivos pagos.
Los pagos pueden cubrir más de una orden de venta

Ejemplo


{
    "id_externa": "123",
    "cliente": 505503,
    "envio": 10490,
    "moneda": "ARS",
    "cotizacion": 1,
    "items": [
        {
            "codigo": "10640/3",
            "cliente": 505496,
            "id_externa": null,
            "id_variacion": null,
            "cantidad": 1,
            "alicuota_iva": 0.21,
            "precio_unitario_neto": 1189.2562,
            "descuento": 0,
        }
    ],
    "pagos": [
        {
            "id_externa":9202966595,
            "plataforma":"mercadopago"
        }
    ]
}

Para mas información

Ver Clientes para mas detalles sobre como consultar y modificar un cliente.
Ver Pedidos para mas detalles sobre como consultar y modificar un pedido.
Ver Envios para mas detalles sobre como consultar y modificar un envio.