AR6 como usar la API REST para crear un cliente o posible cliente

AR6 como usar la API REST para crear un cliente o posible cliente

La API del ERP AR6 ofrece una interfaz programática para interactuar con la base de datos del AR6, permitiendo la creación y consulta de datos de manera eficiente y segura. Está diseñada para desarrolladores que buscan integrar sus aplicaciones o sistemas con nuestro ERP.
Para empezar a usar la API REST del programa de facturación AR6 debes solicitar un TOKEN, que te servira para poder validar la autorización a crear registros en las base de datos.
Para solicitar el TOKEN de acceso, envia una email a info@seoxan.es.
Toda la documentación de la API REST la puedes encontrar en este link: API REST AR6

En este articulo vamos a suponer que queremos enlazar un formulario de nuestra página web al programa de facturación para la captación de leads.
Lo primero que deberiamos hacer es crear un formulario HTML donde recojamos los datos que queremos traspasar al programa de facturación.
El segundo paso seria decidir si queremos crear el lead en la base de datos de posibles clientes o en la de clientes, ya que tenemos definida en la API REST dos end points diferenciados.

En este ejemplo realizamos una petición cURL al end point de crear potenciales clientes en el AR6.

Your_domain es vuestra ruta por la que accedeis al AR6.
Your_token_here es el token suministrado.
@request_body es el codigo en formato json con las variables a crear en el AR6.

curl -X POST "Your_domain/v1/clientes_mkt/create.php" -H "Token: your_token_here" -H "Content-type: application/json" -d @request_body

Aqui teneis un ejemplo de @request_body.
 

{
  "cliente_nombre": "Nombre del Cliente",
  "cliente_nombre_fiscal": "Nombre Fiscal del Cliente",
  "cliente_nif": "X1234567Z",
  "cliente_contacto": "Persona de Contacto",
  "cliente_domicilio": "Domicilio del Cliente",
  "cliente_poblacion": "Población",
  "cliente_cp": "08223",
  "cliente_provincia": "Provincia",
  "cliente_pais": "País",
  "cliente_telefono1": "123456789",
  "cliente_telefono2": "987654321",
  "cliente_telefono3": "",
  "cliente_telefono4": "",
  "cliente_email": "email@cliente.com",
  "cliente_sitioweb": "http://www.sitiowebdelcliente.com",
  "cliente_forma_pago": "1",
  "cliente_cuenta": "ES0081XXXXXXXXXX",
  "cliente_iva": "21",
  "cliente_re": "5.2",
  "cliente_tarifa": "2",
  "cliente_dto": "0",
  "cliente_agente": "1",
  "cliente_contabilidad": "4300123",
  "cliente_entrega_nombre": "Nombre de Entrega",
  "cliente_entrega_domicilio": "Domicilio de Entrega",
  "cliente_entrega_poblacion": "Población de Entrega",
  "cliente_entrega_cp": "Código Postal de Entrega",
  "cliente_entrega_provincia": "Provincia de Entrega",
  "cliente_entrega_pais": "País de Entrega",
  "cliente_advertencia": "Advertencias",
  "cliente_mailmarketing": "-"",
  "cliente_notas": "Notas Adicionales",
  "cliente_web": "",
  "cliente_idioma": "ES",
  "cliente_bic": "BI"
}