Importación de Contratos con API
  • 16 Mar 2022
  • 2 Minutes to read
  • Dark
    Light
  • PDF

Importación de Contratos con API

  • Dark
    Light
  • PDF

Article summary

La API de importación de contratos utiliza la misma interfaz que la importación de contratos en formato csv que se puede realizar desde la Aplicación de Escritorio.

Permite importar contratos de forma masiva.

Es la opción utilizada por la aplicación de escritorio, para la importación de Contratos CSV.

 

Tipo de Llamada: POST

token: facilitado por Nemon ** Solicitar a NEMON

module: ModClients 

class: ClientsImportar 

action: dataFromCSV

APP: TRADEENERGY

 

Los parámetros de filtro asignados en el parámetro data son: 

csv 

 

El contenido que se asignará al parámetro csv, es la cabecera csv (mismos nombres de columnas que en el csv, separados por ; (punto y coma) ), un retorno de carro “\n” ( cadena de texto \n ) y el contenido de cada uno de los campos ( 1 único registro por llamada). El separador del contenido de esta línea para cada uno de los campos es también el carácter ; ( punto y coma ). Los campos de los distintos campos que pueden ser enviados en la API se indican en el documento : Manual de Campos de la importación de Contratos


Ejemplo llamada POSTMAN


Posibles Errores devueltos en la llamada:

201, "Error al intentar cargar un Contrato [CUPS] Reintento [N]"
201, "No se ha encontrado informacion para este CUPS ( [CUPS] )."
201, "El CUPS esta en blanco."
201, "El CUPS ( [CUPS] ) no tiene el formato correcto."
202, "El CUPS ( [CUPS] ) ERROR -> Código \"TipoIndentificador\" incorrecto ( debe ser [1-CIF, 2-DNI, 3-Pasaporte, 4-NIE, 5-N.I.V.A., 6-Otro] )."
406, "El CUPS ( [ CUPS ] ) ERROR IdentificadorFiscal no valido." 
600, "El CUPS ( [CUPS] ) se ha creado en el sistema, pero no se ha encontrado información en el SIPS."
601, "Los consumos en el sips son 0"
602, "El CUPS ( [CUPS] ) tiene un contrato que no está finalizado."
603, "[...] contrato guardado correctamente los siguientes campos incorrectos [...]"
610, 'No se ha encontrado ningún municipio para el CodigoPostalSuministro ( [CodigoPostalSuministro] . ') indicado del CUPS [CUPS]"
611, 'El MunicipioSuministro ( [MunicipioSuministro] ) inidicado no se corresponde con ninguno de los municipios disponibles para el CodigoPostalSuministro ( [CodigoPostalSuministro] ) indicado del CUPS [CUPS]. Los municipios disponibles son los siguientes: ' . $cities_string,
612, 'No se ha encontrado ningún municipio para el CodigoPostalTitular ( [CodigoPostalTitular] ) indicado del CUPS [CUPS]"
613, 'El MunicipioTitular ( [MunicipioTitular] ) inidicado no se corresponde con ninguno de los municipios disponibles para el CodigoPostalTitular ( [CodigoPostalTitular] ) indicado del CUPS [CUPS]. Los municipios disponibles son los siguientes: ' . $cities_string, 
701, "El IBAN ( [IBAN] ) : ERROR-> El valor del campo es incorrecto, no es un International Bank Account Number válido."
700, "El CUPS ( [CUPS]." ) ERROR -> No existe el código de agrupación: [CodigoAgrupacionFactura] . ". Debe ser creado manualmente en el apartado 'Gestión de grupos de contratos'."