Oxxon Comercialización & Distribución

Introduction

This document contais all necessary data to integrate Oxxon Comerializacion & Distrubición with external providers.

API Documentation

Base URL: http://tienda.oxxon-cd.com/api

Add new Customer

Description

Use to add new customer. This process is asynchronous. The new customer will be approved by a agent of Oxxon Comerializacion & Distrubición and it could take beetwen 1 hour to 5 to get the response. The new customer Confirmation will send by email.

Warning: This method require basic auth through header. You have to contact with the tecnical area to gets your auth credentials.

Request Format

Path: /cart/
Method: HttpPost

Headers

Content-Type: multipart/form-data
Accept-Encoding: gzip, deflate, br
Authentication: basic user:pass

Form-Data

{
  METHOD: always be "CreateNewCustomer",
  newCustomer: {"string","string"}
}

newCustomer keys description:

Name	Description	Required
Name			razonsocial	Name with which an entity or commercial company is legally registered.	true
dni			Clave Única de Identificación Tributaria (cuit) or Documento Nacional de identidad (DNI)	true
localidad			The customer town.	true
calle			The customer street.	true
altura			The customer's house number.	true
entrecalles			Streets between the custome'r house or some reference	true
telefono			The customer phone number	true
rubro	The customer bussiness type	true
condventa	The customer invoce type, for example monotributista	true
email	The customer email.	true
horario	The customer time to receive the shipping.	true

Special considerations

DNI

Must be unique. min length is 6. If Cuit is send, the min lenght is 10. Do NOT include less sign (-) if you send CUIT.

HORARIO

The shipping time that we do is since 8 am to 15 pm.*

CONDVENTA

If the customer is not consumidor final, only must send the CUIT number when you send the DNI field.

Response handling

Success/failure exits on the Interface API will be handled via HTTP status codes.

Successful request will get a HTTP 200.

Failure to process the request will be indicated by an HTTP 400’s range status code. The body will contain a single JSON-formatted item with the “ResponseMessage” field.

Sample Messages

Create new Customer

Request:

url: http://tienda.oxxon-cd.com/api/cart/

{
  METHOD: "CreateNewCustomer",
  newCustomer: {
                "razonsocial":"gardelito SA",
                "dni":"30648839088",
                "localidad":"Burzaco",
                "calle":"Chacabuco",
                "altura":"1976",
                "entrecalles":"Esquina libertad",
                "telefono":"1535889858",
                "rubro":"kiosko",
                "condventa":"consumidor final",
                "email":"[email protected]",
                "horario":"9 a 18"
              }
}

chaosknt / oxxon_api-cart Goto Github PK

oxxon_api-cart's Introduction