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: A3FACTURAGO PYME FACTGO-CON: A3FACTURAGO PYME CONECTIA FACTPRO: A3FACTURAPRO PYME FACTPRO-CON: A3FACTURAPRO PYME CONECTIA	S
tarifa	String	10	Código de la tarifa. Valores posibles: TA02: ANUAL A001: MENSUAL	S
accionComercial	String	10	Dejar en blanco, salvo que conozcas un código de acción comercial válido	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": "A001",
  "accionComercial": "",
}

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, se enviará la invitación de onboarding de a3factura al email de contacto informado en el campo email de la petición POST