Importador de clientes

Nombre de la parte de datos: cliente. Recibe una sola tabla (clientes) con un registro por cliente. El cliente se identifica por codigo (sin distinguir mayúsculas): si existe se actualiza (allowUpdate) y si no existe se crea (allowCreate).

Los códigos de las demás entidades tienen que existir; si no, el registro se rechaza con un mensaje del tipo “La sede X no existe”.

Datos generales y fiscales

Campo	Tipo	Descripción
codigo	string	Obligatorio. No puede repetirse en el archivo.
nombre	string	Obligatorio. Nombre de fantasía. Hasta 120 caracteres.
razonSocial	string	Obligatorio. Hasta 100 caracteres.
codigoTipoDocumento	string	Obligatorio. Código del tipo de documento.
documento	string	Obligatorio. Hasta 80 caracteres.
codigoCondicionIva	string	Obligatorio. Código de condición de IVA.
codigoSituacionIb	string	Opcional. Situación de ingresos brutos.
nroIngresosBrutos	string	Hasta 80 caracteres.
telefono	string	Hasta 40 caracteres.
contacto	string	Hasta 120 caracteres.
email	string	Hasta 50 caracteres.
comentario	string	Hasta 200 caracteres.
notas	string	Hasta 300 caracteres.
activo	boolean	Solo se aplica al actualizar: los clientes nuevos siempre se crean activos.
tipoInactivo	string	`CierreDefinitivo`, `PorTemporada` o `Potencial`. Default `CierreDefinitivo`. Un cliente con `activo` = false necesita un tipo de inactivo: si se envía vacío, el registro se rechaza.
etiquetas	string	Etiquetas separadas por `;` o `,`. Las que no existen se crean. Se reemplazan las etiquetas del cliente por las enviadas (las de solo lectura se conservan). Hasta 200 caracteres.

Dirección fiscal

Campo	Tipo	Descripción
direccion_Provincia	string	Obligatorio. Nombre de la provincia (ej. `Santa Fe`), tal como figura en el sistema.
direccion_Localidad	string	Nombre de la localidad. Si coincide con una localidad de esa provincia se vincula; si no, se guarda solo como texto.
direccion_Calle	string	Hasta 100 caracteres.
direccion_Altura	int
direccion_Detalles	string	Piso, departamento, etc. Hasta 100 caracteres.
direccion_CodigoPostal	string	Hasta 20 caracteres.
direccion_Notas	string	Hasta 300 caracteres.
direccion_Latitud, direccion_Longitud	decimal	Coordenadas. Si no se envían, se completan con las de la empresa.
direccion_UbicacionGpsAproximada	boolean	Indica que las coordenadas son aproximadas.
usarDireccionFiscalParaEntrega	boolean	`true`: la dirección de entrega es la fiscal y los campos `entrega_*` se ignoran.

Dirección de entrega (si usarDireccionFiscalParaEntrega es false)

Campo	Tipo	Descripción
entrega_Provincia	string	Nombre de la provincia.
entrega_Localidad, entrega_Calle	string	Hasta 100 caracteres cada uno.
entrega_Altura	int
entrega_Detalles	string	Hasta 200 caracteres.
entrega_CodigoPostal	string	Hasta 20 caracteres.
entrega_Notas	string	Hasta 300 caracteres.
entrega_Latitud, entrega_Longitud	decimal
entrega_UbicacionGpsAproximada	boolean	Default `true`.

Datos comerciales

Campo	Tipo	Descripción
codigoSede	string	Obligatorio.
codigoSubRamo	string	Obligatorio.
codigoCondicionPago	string	Obligatorio.
codigoListaPrecioGeneral	string	Obligatorio. Tiene que ser una lista general.
codigoSegmento	string	Obligatorio. Segmento de cliente.
minimoDeVenta	decimal	Importe mínimo de venta. Default 0.
minimoDeVentaCodigoMoneda	string	Obligatorio. Moneda del mínimo de venta.
topeSaldoDinero	decimal	Opcional. Tope de saldo en dinero.
topeSaldoDineroCodigoMoneda	string	Obligatorio (aunque no se envíe tope). Moneda del tope de saldo.
topeSaldoBoletas, topeSaldoDias	int	Opcionales.
codigoEmpresa	string	Opcional.
codigoDeposito	string	Opcional.
listasParticulares	string	Códigos de listas de precios particulares separados por `;` o `,`, en orden de prioridad. No pueden ser listas generales. Se reemplazan las listas del cliente por las enviadas.
promociones	string	Nombres de promociones particulares separados por `;` o `,`. No pueden ser promociones globales. Se reemplazan las del cliente por las enviadas.
metodoEntrega	string	`EnvioDomicilio`, `RetiroDirecto` o `RetiroPorDeposito`.
codigoDemoraEntrega	string	Opcional.
ordenReparto	int	Opcional.
horarioAtencion, horarioEntrega	string	Hasta 100 caracteres. Solo se aplican al actualizar.
nroHabilitacionAlcohol	string	Hasta 80 caracteres.
categoriaHabilitacionAlcohol	string	Hasta 120 caracteres. Solo se aplica al actualizar.
vencimientoHabilitacionAlcohol	fecha

En las listas separadas por ; o , no dejar espacios después del separador: el valor con espacio no se encuentra y el registro se rechaza.

Ejemplo

[
    [
        {
            "codigo": "4",
            "nombre": "Clientes Varios",
            "razonSocial": "Clientes Varios",
            "codigoTipoDocumento": "99",
            "documento": "10000000",
            "codigoCondicionIva": "IVANA",
            "codigoSituacionIb": "4",
            "direccion_Provincia": "Santa Fe",
            "direccion_Localidad": "Villa Gobernador Gálvez",
            "direccion_Calle": "GARCIA GONZALEZ",
            "direccion_Altura": 2919,
            "direccion_Latitud": -33.0263,
            "direccion_Longitud": -60.6334,
            "direccion_UbicacionGpsAproximada": true,
            "usarDireccionFiscalParaEntrega": true,
            "codigoEmpresa": "E1",
            "codigoSede": "1",
            "codigoDeposito": "GEN",
            "codigoSubRamo": "111",
            "codigoCondicionPago": "15D",
            "codigoListaPrecioGeneral": "1",
            "listasParticulares": "4;5",
            "promociones": "",
            "topeSaldoDinero": 0,
            "topeSaldoDineroCodigoMoneda": "ARS",
            "topeSaldoBoletas": 0,
            "topeSaldoDias": 0,
            "minimoDeVenta": 0,
            "minimoDeVentaCodigoMoneda": "ARS",
            "codigoSegmento": "P",
            "metodoEntrega": "EnvioDomicilio",
            "activo": true,
            "tipoInactivo": "CierreDefinitivo",
            "etiquetas": ""
        }
    ]
]

Opciones

allowCreate: crea el cliente con su entidad, entidad fiscal, direcciones, etiquetas, listas particulares, promociones y los impuestos que el sistema agrega por defecto.
allowUpdate: actualiza todos los campos de los clientes existentes. Los campos que no se envían quedan vacíos (se actualizan con null o su valor por defecto).
allowRemove: inactiva (tipo CierreDefinitivo) todos los clientes activos que no vinieron en el archivo. Hoy no se verifica si el cliente tiene comodatos pendientes.