Realiza pedidos de licencias de a3factura

Obtención del registerToken

Para poder lanzar peticiones a la API de pedidos de a3factura Conectia, necesitarás primero obtener un Access-token. Sigue estos pasos:

Paso 1: Autenticación

Deberás realizar una solicitud HTTP POST a

https://services.eiswktaa.es/oauth2/token?scope=partners&grant_type=client_credentials

con la autenticación básica utilizando el nombre de usuario y la contraseña que te hemos proporcionado:

• Encabezados: Authorization: Basic Base64(Usuario:Contraseña)
• Deberás codificar en Base64 el par Usuario:Contraseña (importante no olvidar los dos puntos entre Usuario y Contraseña)

Por ejemplo, para el usuario Test1 con contraseña 12345$Password enviaríamos la siguiente petición para solicitar un Access-token con el alcance partners.

curl --location --request POST 'https://services.eiswktaa.es/oauth2/token?scope=partners&grant_type=client_credentials' \
--header 'Authorization: Basic VGVzdDE6MTIzNDUkUGFzc3dvcmQ='

Y si la petición es correcta devolverá un body-response:

{
    "access_token": "c7b59aaa3116bc4a2ff8df6fc01d92ee",
    "Clienteid": "Test1",
    "token_type": "Bearer",
    "expires_in": 3600
}

Atención

El Access-Token obtenido tiene una caducidad de una hora. Transcurrido ese tiempo, deberás obtener uno nuevo realizando de nuevo la misma petición.

Paso 2: Alta de pedidos de nuevas licencias de a3factura

Deberás realizar una solicitud HTTP POST a

https://bk.eiswktaa.es/a3facturapedido/api/v1/newOrder

con el header de Authorization tipo Bearer con el Access-token obtenido en el paso anterior, y un body-requesten formato json con la siguiente información:

Parámetros de entrada:

Parámetro	Tipo	Formato	Descripción	Obligatorio
nifcif	String	25	Nif / Cif válido del cliente	S
nombreCliente	String	200	Razón social	S
nombreVia	String	50	Nombre de la calle	S
tipoVia	String	200	Tipo de la Vía (CL , AV …)	S
numVia	String	80	Número de la Vía	S
numEscalera	String	40	Escalera	N
numPlanta	String	40	Número de la planta	N
numPuerta	String	4	Número de la puerta	N
codPostal	String	80	Codigo Postal	S
nombreMunicipio	String	200	Nombre del municipio	S
nombreProvincia	String	200	Nombre de la Provincia	S
numTelefono	Number	15	Número de teléfono	S
nombreContacto	String	1000	Nombre del contacto	S
apellidoContacto	String	1000	Apellido del contacto	S
email	String	1000	Email del contacto al que se enviará la invitación para realizar el onboarding de a3factura	S
producto	String	16	Código de producto. Valores posibles: FACTGO-CON: A3FACTURAGO PYME CONECTIA	S
tarifa	String	10	Código de la tarifa. Deberás informar el código de tarifa que te hemos facilitado en el acuerdo	S
accionComercial	String	10	Deberás informar el código de acción comercial que te hemos facilitado en el acuerdo	N

Por ejemplo:

{
  "nifcif": "14723301N",
  "nombreCliente": "Graciela Bustillo",
  "nombreVia": "Jacobinia",
  "tipoVia": "CL",
  "numVia": "18",
  "numEscalera": "",
  "numPlanta": "",
  "numParte": "",
  "codPostal": "28047",
  "nombreMunicipio": "Madrid",
  "nombreProvincia": "Madrid",
  "numTelefono": 699262609,
  "nombreContacto": "Graciela",
  "apellidoContacto": "Bustillo",
  "email": "graciel.bustillo@gmail.com",
  "producto": "FACTGO-CON",
  "tarifa": "XXXX",
  "accionComercial": "XXXX",
}

Parámetros de salida:

Parámetro	Tipo	Formato	Descripción
status	String	50	Estado de la respuesta
cliente	Number	8	Código del Cliente generado o existente
ubicacion	Number	4	Código de Ubicación generado o existente
contacto	Number	6	Código de Contacto generado o existente
boletin	String	8	Código de boletín generado
message	String	200	Mensaje del proceso.

{
  "status": "OK",
  "cliente": 63286242,
  "ubicacion": 1,
  "contacto": 1,
  "boletin": 29520640,
  "message": "Proceso terminado correctamente. Cliente Creado."
}

{
  "status": "KO",
  "tipoerror": "DATA_MISSING_CANCELLED",
  "error": "El nif/cif esta vacio."
}

Códigos Respuesta HTTP:

Código	Descripción
200	Solicitud procesada correctamente.
400	La llamada ha fallado.

Importante

Si la respuesta es un OK, pasado un corto periodo de tiempo, recibirás una petición a tu endpoint con toda la información de la licencia de a3factura Conectia aprovisionada