NOTAS TÉCNICAS SOBRE EL SIT: Emisión Electrónica de Documentos (EDI)
Introducción 2 Introducción...3 Ventajas del Módulo de Comercio Electrónico... 3 WSDL (Web Services Description Language)...3 Identificación del usuario SOAP... 3 Acceso de los usuarios SOAP... 4 Prestaciones...4 Identificación del usuario... 4 Obtención de Catálogo de Artículos... 4 Envío de Pedidos de Cliente... 4 Formato XML de Ficha de Cuenta...5 Datos de la empresa... 5 Datos de la entidad... 5 Datos de la cuenta... 6 Para cada Contacto Personal... 6 Formato XML de Documento Comercial...6 Datos generales... 6 Registro del emisor... 7 Registro del Receptor (Cliente/Proveedor)... 7 Registros de Cabeceras... 7 Para facturas expedidas... 7 Registros de Líneas del Documento... 8 Registros de Cobros por TPV... 9 Registros de Comentarios... 9 Registros de Avisos... 9 Formato XML de Artículo...10 Datos generales...10 Artículos Accesorios...10
Introducción 3 Emisión Electrónica de Documentos (EDI) Introducción El SIT ofrece, entre sus módulos, uno de Comercio Electrónico. El objetivo es el de permitir a las terceras partes (clientes, proveedores, etc.) que no tienen acceso al SIT de la empresa mediante el cliente SIT, una forma directa de introducir o modificar datos dentro de éste. Ventajas del Módulo de Comercio Electrónico 1. Universalidad: Posibilidad de crear o modificar datos del SIT mediante un navegador WEB. 2. Ubicuidad: las modificaciones pueden realizarse desde cualquier ordenador conectado a Internet desde cualquier parte del mundo. 3. Personalización: la Empresa puede diseñar páginas WEB propias que incluyen las órdenes necesarias para actuar sobre el SIT. 4. Estandarización: el lenguaje utilizado para la comunicación entre el SIT y el navegador web es SOAP (Simple Object Access Protocol), un estándar de comunicaciones informáticas basado en XML (Extensible Markup Language). 5. Seguridad: el módulo incluye un sistema de identificación para verificar la autenticidad de las conexiones. Asimismo permite SSL (Secure Sockets Layer) en las conexiones entre el navegador WEB y el SIT. 6. Facilidad en la Implementación: el lenguaje SOAP prevé un sistema de documentación por la que el diseñador web, mediante herramientas de ayuda, puede descubrir los servicios y las especificaciones de cada servicio prestados por el SIT sin necesidad de documentación accesoria. WSDL (Web Services Description Language) Para descubrir los servicios y especificaciones técnicas de los servicios prestados por el SIT, basta con conectarse al mismo con una utilidad SOAP que lo permita. La dirección donde se encuentra el WSDL del SIT es http://direcciondelservidorsit/4dwsdl. Identificación del usuario SOAP Siempre que se vaya a realizar una conexión SOAP será imprescindible realizar una tarea de identificación. En el SIT se pueden autorizar acceso SOAP a dos tipos de usuario: 1. Usuarios del SIT 2. Contactos Personales de cualquier cuenta. Dependiendo de la naturaleza del usuario SOAP, el programa permitirá ejecutar distintas operaciones mediante los comandos SOAP.
Prestaciones 4 Acceso de los usuarios SOAP 1. Usuarios del SIT: acceda a la ficha de usuario y active el privilegio de acceso Peticiones SOAP. El nombre de usuario y contraseña que deberá usar el usuario para acceder al SIT mediante SOAP son los mismos que figuran en su ficha de usuario. 2. Contactos Personales: acceda a la ficha de un contacto personal. En la solapa Acceso WEB, marque la opción Permitir Acceso e introduzca un nombre y contraseña para el usuario. El contacto personal podrá visualizar y modificar información relacionada con la cuenta a la que dicho contacto está asociada. Si el contacto no está asociado a ninguna cuenta, no tendrá ninguna operativa disponible. Prestaciones Identificación del usuario SOAP_Login. Este comando permite, enviando un nombre de usuario y contraseña, obtener una sesión de trabajo. Los comandos subsiguientes pedirán la identificación de dicha sesión para poder ser ejecutados. Obtención de Catálogo de Artículos Para disponer en un servidor WEB de unas tarifas e información de existencias sobre los artículos disponibles en el SIT, proceda así: SOAP_EnviarListadoRegistros: Este comando, mediante el envío de la identificación de la sesión, y como segundo argumento Articulos, devuelve un fichero XML con los números de registro y de versión de los artículos disponibles en el SIT. SOAP_EnviarRegistro: Con el envío de la identificación de la sesión, el fichero del que deseamos obtener un registro ( Articulos ), el Código del artículo (si se conoce) y el Número de Registro. El SIT devuelve un fichero XML con los datos del artículo referentes a Tarifas de Precios y existencias disponibles. Envío de Pedidos de Cliente Mediante el módulo de Comercio Electrónico del SIT, la empresa puede permitir que sus clientes introduzcan, sin intervención de la propia empresa, sus pedidos en el SIT. Para implementar esta utilidad, basta con incluir en la página web de la empresa y en su propio dominio, o en cualquier otra página web publicada en Internet, el código SOAP siguiente: SOAP_RecibirDocumentoComercial. Este comando exige dos argumentos: la identificación de la sesión y el fichero de texto conteniendo el documento comercial que se quiere introducir en el SIT.
Formato XML de Ficha de Cuenta 5 Formato XML de Ficha de Cuenta El procedimiento SOAP_RecibirFichaCuenta accesible a través de servicios WEB del SIT, proporciona un medio de introducción en el SIT de fichas completas de entidades, cuentas y contactos personales. El procedimiento devuelve el número de Registro que el SIT asigna al registro de cuenta. En el procedimiento: 1. La entidad se creará si no existe ninguna con el mismo NIF o, si no existe ninguna con la misma Descripción. 2. La cuenta se creará sólo si la entidad no tiene ninguna cuenta asignada del tipo y subtipo que se envía. 3. Los contactos personales sólo se crearán si no existen con el mismo nombre y apellidos o bien con el mismo departamento. Datos de la empresa /FichaCuenta/Empresa/DNI La cuenta se creará en la empresa cuyo DNI se envíe o, en su ausencia, la empresa que figure en <Preferencias:Empresa Principal> Datos de la entidad /FichaCuenta/Entidad/Descripcion /FichaCuenta/Entidad/NombreComercial /FichaCuenta/Entidad/Actividad /FichaCuenta/Entidad/OrigenComercial /FichaCuenta/Entidad/DNI /FichaCuenta/Entidad/DNITipo /FichaCuenta/Entidad/TipoSociedad /FichaCuenta/Entidad/Pais /FichaCuenta/Entidad/PaisResidencia /FichaCuenta/Entidad/Provincia /FichaCuenta/Entidad/CodigoPostal /FichaCuenta/Entidad/Poblacion /FichaCuenta/Entidad/Direccion /FichaCuenta/Entidad/Telefono /FichaCuenta/Entidad/Fax /FichaCuenta/Entidad/ServidorWEB /FichaCuenta/Entidad/Alta Numérico Boleano
Formato XML de Documento Comercial 6 Datos de la cuenta /FichaCuenta/Cuenta/Descripcion /FichaCuenta/Cuenta/TipoCuenta /FichaCuenta/Cuenta/SubTipoCuenta /FichaCuenta/Cuenta/Alta Boleano (Los datos de dirección sólo se envían si son distintos de los de la entidad). /FichaCuenta/Cuenta/Pais /FichaCuenta/Cuenta/Provincia /FichaCuenta/Cuenta/CodigoPostal /FichaCuenta/Cuenta/Poblacion /FichaCuenta/Cuenta/Direccion /FichaCuenta/Cuenta/Telefono /FichaCuenta/Cuenta/Fax /FichaCuenta/Cuenta/ServidorWEB Para cada Contacto Personal /FichaCuenta/ContactoPersonal/Nombre /FichaCuenta/ContactoPersonal/Apellido1 /FichaCuenta/ContactoPersonal/Apellido2 /FichaCuenta/ContactoPersonal/Departamento /FichaCuenta/ContactoPersonal/Cargo /FichaCuenta/ContactoPersonal/Saludo /FichaCuenta/ContactoPersonal/CorreoElectronico /FichaCuenta/ContactoPersonal/NivelAcceso /FichaCuenta/ContactoPersonal/Alta /FichaCuenta/ContactoPersonal/Idioma /FichaCuenta/ContactoPersonal/Observaciones Numérico Boleano Formato XML de Documento Comercial Ha de ser un Fichero XML válido, con la siguiente estructura del fichero: Datos generales Nombre del Documento: DocumentoElectronico
Formato XML de Documento Comercial 7 Registro del emisor Emisor/NIF NIF de la Empresa NIF Registro del Receptor (Cliente/Proveedor) Receptor/NIF NIF del Cliente/Proveedor NIF Registros de Cabeceras Cabecera del Documento Comercial: Cabecera/TipoDocumento Tipo del Docoumento Valores: FacturaExpedida, AlbaranCliente; FacturaRecibida; AlbaranProveedor, etc Cabecera/Serie Código de la Serie Para facturas expedidas Cabecera/Registro Número de Registro Numérico Número único de registro del documento en la base de datos remota. El SIT lo guardará en el campo Sincronización Cabecera/Observaciones Observaciones Cabecera/Fecha Fecha Fecha Cabecera/CodigoAlmacen Código del Almacén Cabecera/NumeroDocumento Nº de Documento Numérico En Facturas Expedidas, el nº de secuencia dentro de la serie. En resto de documentos, número de documento Cabecera/Contacto Contacto Nombre y Apellidos del Contacto Personal Cabecera/TipoIRPF TipoIRPF Numérico Sin retención Profesionales Renta inmobiliaria Capital mobiliario Agricultores Actividades empresariales Cabecera/FechaEntrega Fecha de Entrega/Recepción Fecha Cabecera/MedioPago Medio de Pago EF=Efectivo = 1 CH=Cheque = 2 TR=Transferencia = 3 LT=Letra =4
Formato XML de Documento Comercial 8 PG=Pagaré = 5 TC=Tarjeta Crédito = 6 DB=Domiciliación bancaria = 7 CR=Contra Reembolso = 8 OT=Otras/A determinar = 9 CF=Confirming = 10 FC=Factoring = 11 TI=Transferencia internacional = 12 CI=Cheque internacional = 13 RA=Recibo Aceptado = 14 TPV=Venta TPV = 15 LS=Leasing/Financiación = 16 Cabecera/Estado Estado del Documento Los valores posibles para cada tipo de documento Cabecera/PagoNumeroPagos Medio de pago Numérico Número de cobros/pagos (Vencimientos) a generar. Normalmente 1. Cabecera/PagoPlazo1 Medio de pago Numérico Plazo en días a contar de la fecha de la factura. Al contado: 0 Días. Cabecera/PagoPlazoResto Medio de pago Numérico Si existen más vencimientos, plazo entre cada uno de ellos. Cabecera/PagoDia1 Medio de pago Numérico Si el cliente tiene un día de pago concreto o varios. Opcional. Cabecera/PagoDia2 Medio de pago Numérico Si el cliente tiene un día de pago concreto o varios. Opcional. Cabecera/PagoDia3 Medio de pago Numérico Si el cliente tiene un día de pago concreto o varios. Opcional. Registros de Líneas del Documento (Ilimitadas líneas por documento). Linea/CodigoArticulo Código del Artículo Linea/AlbaranNumero Número de Albarán Origen Numérico Si se trata de una factura expedida, número del albarán de origen Linea/AlbaranFecha Fecha de Albarán Origen Fecha Si se trata de una factura expedida, fecha del albarán de origen En Facturas Expedidas, es necesario reportar el albarán de origen. El SIT, al recibir el documento Factura Expedida, busca, por cada cada línea, la linea correspondiente en el albarán de origen y la factura, por lo que es necesario haber reportado previamente los albaranes correspondientes a la factura. Linea/Descripcion Descripción
Formato XML de Documento Comercial 9 Linea/Cantidad Cantidad Numérico Linea/PrecioUnitario Precio Numérico Linea/Descuento Descuento Linea/IVA % IVA Numérico Linea/IRPF % IRPF Numérico Linea/RE % RE Numérico Linea/Origen/RegistroOrigen Registro del documento Origen Numérico Si la línea de albarán proviene de un pedido anterior, número de registro de ese pedido en la base de datos remota. Linea/Origen/TipoDocumento Tipo del documento Origen Numérico Si la línea de albarán proviene de un pedido anterior, constante= 5 (Pedido de cliente) Registros de Cobros por TPV Cobro/Fecha: Fecha Fecha Cobro/Caja Código de la Caja TPV Cobro/FormaCobro Código de Forma de Cobro TPV Cobro/Concepto Concepto Cobro/Entrada Importe Entrada Numérico Cobro/Salida Importe Salida Numérico Registros de Comentarios Comentario/Usuario Nombre del Usuario Comentario/Fecha Fecha Fecha Comentario/Hora Hora Hora Comentario/ Registros de Avisos Aviso/Usuario Nombre Usuario Aviso/Fecha Fecha Fecha Aviso/Hora Hora Hora Aviso/Asunto Asunto Aviso/
Formato XML de Artículo 10 Formato XML de Artículo Ha de ser un Fichero XML válido, con la siguiente estructura del fichero: Datos generales RegistroSITArticulos/Registro RegistroSITArticulos/Codigo RegistroSITArticulos/Descripcion RegistroSITArticulos/Estado RegistroSITArticulos/Tipo RegistroSITArticulos/PrecioVenta1 RegistroSITArticulos/PrecioVenta2 RegistroSITArticulos/PrecioVenta3 RegistroSITArticulos/PrecioVentaIVA1 RegistroSITArticulos/PrecioVentaIVA2 RegistroSITArticulos/PrecioVentaIVA3 RegistroSITArticulos/Costo RegistroSITArticulos/IVA RegistroSITArticulos/RE RegistroSITArticulos/Comision RegistroSITArticulos/Divisa RegistroSITArticulos/Estado RegistroSITArticulos/Observaciones RegistroSITArticulos/Descuento RegistroSITArticulos/RegistroFabricante RegistroSITArticulos/FamiliaCodigo RegistroSITArticulos/FamiliaNombre RegistroSITArticulos/Version Registro Codigo Descripcion Estado Tipo PrecioU1 PrecioU2 PrecioU3 PrecioIVA1 PrecioIVA2 PrecioIVA3 Costo IVA RE ComisionP Divisa Estado Observaciones Descuento Registro Fabricante Código Familia Nombre Familia Version Artículos Accesorios RegistroSITArticulos/Accesorios/Codigo RegistroSITArticulos/Accesorios/Descripcion RegistroSITArticulos/Accesorios/Cantidad RegistroSITArticulos/Accesorios/Precio Código del Artículo Accesorio Descripción Cantidad Precio
Formato XML de Artículo 11