Formato de mensajes de notificación - Ge-factura

Guía de la Notificación
Proveedores GVA
(XML_NOTIFICACION_GEFACTURA)
Fecha: Junio 2015
Índice
1. INTRODUCCIÓN ........................................................................................................... 3
2. ESTRUCTURA DEL MENSAJE. ....................................................................................... 4
1.
Introducción
Las Generalitat Valenciana
XML_NOTIFICACION_GEFACTURA.
principales.
(GVA) emite un mensaje XML llamado
Dicho mensaje, tiene dos propósitos

Notificar al proveedor cambios en el estado de cada factura emitida por parte
del proveedor e informar de los motivos de devolución o de los errores que
puedan tener.

Notificar al proveedor cambios en la libreta de direcciones de la plataforma
geFactura.
2. Estructura del mensaje.
2.1 NOTIFICACION_GEFACTURA.
El elemento raíz del mensaje agrupa toda la estructura de la notificación. Datos
de cabecera o atributos relativos al propio mensaje (referencia, fecha, etc.) y
elementos que componen el resto del mensaje y dan la funcionalidad al mismo.
Un mensaje de notificación solo puede tener una función, es decir solo puede
referirse al cambio de estado de una factura enviada o a una modificación de la libreta
de direcciones. No se indican distintas acciones en el mismo mensaje.
2.1.1 Atributos
Los atributos de la cabecera son los siguientes.
Nombre
Propósito
REFERENCIA
Numero de referencia de la notificación.
M/
O
M
Tipo
ORIGEN
Origen del documento.
M
String
DESTINO
Destino del documento.
M
String
FECHA
Fecha de la notificación
M
String
DOMINIOORIGEN
Dominio origen de la notificación
M
String
TRANSMITCODE
Código único de transmisión de la factura
M
String
String
2.1.2 Elementos
Los elementos que componen el mensaje de notificación son los que se
relacionan a continuación. Solo aparecerá uno de los elementos por lo que se marcan
como Opcionales pero siempre debe haber uno de ellos:
Nombre
Propósito
M/
O
O
CAMBIOESTADO
Indica que toda la información que contiene está
relacionada con el cambio de estado de una
factura.
ALTA_PO
Tipo
String
Indica un alta en la libreta de direcciones y
contiene
la
información
necesaria
del
departamento creado.
O
String
BAJA_PO
Indica la baja de la libreta de direcciones un solo
departamento o punto operacional.
O
String
BAJA_DEPTO
Indica la baja de la libreta de direcciones de un
departamento y todos los departamentos que
dependan de él.
O
String
MODIFICA_PO
Indica una modificación en los datos que
componen un departamento (nombre, dirección,
etc.)
O
String
Nombre
SINCRO_PO
Propósito
Con esta función la GVA informa a los
proveedores de todos los departamentos que
componen su estructura.
M/
O
O
Tipo
String
2.2 CAMBIOESTADO.
2.2.1 Propósito
El grupo de elementos de cambio de estado se utiliza para indicar cambio de
estado en la plataforma de la GVA. Se indica el nuevo estado al que pasa y la
información asociada al mismo. Referencias en caso de registrarse o devolverse y los
errores en caso de que la factura haya quedado errónea.
2.2.2 Atributos CAMBIOESTADO
Nombre
Propósito
REFERENCIA
Número de
proveedor.
ESTADO
Estado al que ha cambiado la factura:
factura
emitida
por
el
M/
O
M
Tipo
String
M
String
REG = Registrada
RCF = Registrada en Registro Contable
LEI = Leída
CNF = Aceptada
PPA = Propuesta de Pago
PAG = Pagada
ANU = Anulada
DEV = Devuelta
ERR = Error
NUMERO_REGISTRO_E
Número de Registro de Entrada.
O
String
FECHA_REGISTRO_E
Fecha de Registro de Entrada.
O
String
NUMERO_REGISTRO_S
FECHA_REGISTRO_S
Número de Registro de Salida.
Fecha de Registro de Salida.
O
O
String
String
MOTIVO_DEVOLUCION
Motivo de devolución de la factura
(en caso de ESTADO = DEV).
O
String
ERROR
Descripción en texto libre del error.
O
String
IDRUF
Identificador en el Registro Único de
Facturas (Registro Contable)
Código hash de la factura
Estado anterior en el que se encontraba la
factura
Código de la Oficina Contable a la que va
destinada la factura
O
String
M
O
String
String
O
String
M/
O
M
Tipo
HASHINT
ESTADO_ANTERIOR
OFICINACONTABLE
2.2.3 Atributos ERROR
Nombre
ERROR
Propósito
Número secuencial para cada elemento de error.
String
Nombre
CODIGO
Propósito
Tipo de error:
M/
O
M
Tipo
String
M
String
POS = Problemas relativos a la libreta
de direcciones.
MAP = Errores sintácticos en la construcción
de la factura.
VAL = Errores semánticos relativos a los
datos de la factura.
IECTE = Problemas varios al procesar
la factura.
CRIPTO = Problemas al verificar la firma
de la factura.
DESCRIPCION
Descripción en texto libre del error.
2.2.4 Ejemplos XML
ESTADO REGISTRADA
<NOTIFICACION_GEFACTURA
REFERENCIA="2011092015233658745877454545"
ORIGEN="G100061234"
DESTINO="ESB1234567"
FECHA="2011-09-20T16:22:00.130"
DOMINIOORIGEN="S4611001A"
TRANSMITCODE="1506152049471583231000">
<CAMBIOESTADO
REFERENCIA="5015353"
ESTADO="REG"
NUMERO_REGISTRO_E="08854/12345"
FECHA_REGISTRO_E="2011-09-20T16:21:58.000"
IDRUF="5092.2011.R"
HASHINT="VTMPFYYJGZ1QAR7DBBP7EW9BC/0="/>
</NOTIFICACION_GEFACTURA>
ESTADO DEVUELTA
<NOTIFICACION_GEFACTURA
REFERENCIA="201108161749857239853985390"
ORIGEN="G100061234"
DESTINO="ESB1234567"
FECHA="2011-08-16T13:31:39.896"
DOMINIOORIGEN="S4611001A"
TRANSMITCODE="1506152049471583231000">
<CAMBIOESTADO
REFERENCIA="5015353"
ESTADO="DEV"
NUMERO_REGISTRO_S="02552/588740"
FECHA_REGISTRO_S="2011-08-16T13:31:37.000"
MOTIVO_DEVOLUCION="99:OTROS. PRECIO ERRONEO "
HASHINT="VTMPFYYJGZ1QAR7DBBP7EW9BC/0=" />
</NOTIFICACION_GEFACTURA>
ESTADO ERROR
<NOTIFICACION_GEFACTURA
REFERENCIA="2011032816335356456676767"
ORIGEN="G100061234"
DESTINO="ESA1234567"
FECHA="2011-03-28T16:39:35.829"
DOMINIOORIGEN="S4611001A"
TRANSMITCODE="1506152049471583231000" >
<CAMBIOESTADO
REFERENCIA="5015353"
ESTADO="ERR"
HASHINT="VTMPFYYJGZ1QAR7DBBP7EW9BC/0=">
<ERROR
NUMERO="1"
CODIGO="CRIPTO"
DESCRIPCION="Error: Firma del documento erronea" />
<ERROR
NUMERO="2"
CODIGO="CRIPTO"
DESCRIPCION="Error al verificar el intercambio" />
</CAMBIOESTADO>
</NOTIFICACION_GEFACTURA>
2.3 ALTA_PO.
2.3.1 Propósito
El grupo de elementos de alta de punto operacional se utiliza para indicar la creación
de un nuevo departamento en la libreta de direcciones de la GVA. Se informan los datos
significativos que componen dicho departamento.
2.3.2 Atributos
Nombre
Propósito
M/
O
M
Tipo
String
CODINTERLOCUTOR
Código del departamento del que se
informa.
PADRE
Código del nodo raíz (entidad) al que
pertenece el punto del que se informa.
M
String
NOMBRE
Nombre del departamento del que se
informa.
M
String
DOMICILIO
Domicilio del departamento del que se
informa.
M
String
POBLACION
Población del departamento del que se
informa.
M
String
CP
CP del departamento
informa.
se
M
String
PROVINCIA
Provincia del departamento del que se
informa.
M
String
PAIS
País del departamento del que se
informa.
Formato Alpha-2
M
String
NIF
NIF del departamento del que se
informa.
O
String
GV_TIPODESTINATARIO
Tipo de departamento:
M
String
del que
RF = Receptor de facturas.
RM = Receptor de mercancías.
RFM = Receptor de facturas
mercancías.
NR = No receptor.
y
GV_CODIGOJERARQUICO
Código Jerárquico del departamento del
que se informa en el árbol de nodos de
la plataforma geFactura.
M
String
ES_CONTACTO
Persona de contacto del departamento
del que se informa.
O
String
2.3.3 Ejemplo XML
<NOTIFICACION_GEFACTURA
REFERENCIA="2009100209279869785906795"
ORIGEN="ESS55478996"
DESTINO="ESA1234567"
FECHA="2009-10-02T09:27:25.391"
DOMINIOORIGEN="S4611001A" >
<ALTA_PO
CODINTERLOCUTOR="G11SGGFR"
PADRE="ESS55478996"
NOMBRE="SERVICIO PRINCIPAL"
DOMICILIO="C/MAYOR, 32"
POBLACION="VALENCIA"
CP="46004"
PROVINCIA="VALENCIA"
PAIS="ES"
NIF=""
GV_TIPODESTINATARIO="RFM"
GV_CODIGOJERARQUICO="ESS55478996 .G11.G11SGGFR"
ES_CONTACTO="Contacto" />
</NOTIFICACION_GEFACTURA>
2.4 BAJA_PO.
2.4.1 Propósito
El grupo de elementos de baja de punto operacional se utiliza para eliminar un
departamento específico. Como los códigos de los departamentos son únicos tan solo se
informa del código que hay que borrar.
2.4.2 Atributos
Nombre
CODINTERLOCU
TOR
Propósito
Código de punto que se da de baja.
2.4.3 Ejemplo XML
<NOTIFICACION_GEFACTURA
REFERENCIA="2009111254657965468796548"
ORIGEN="ESS55478996"
DESTINO="ESA1234567"
FECHA="2009-11-10T14:01:15.668"
DOMINIOORIGEN="S4611001A" >
<BAJA_PO
CODINTERLOCUTOR="G0654548" />
</NOTIFICACION_GEFACTURA>
M/
O
M
Tipo
String
2.5 BAJA_DEPTO.
2.5.1 Propósito
El grupo de elementos de baja de departamento se utiliza para eliminar un
departamento de la libreta de direcciones y todos los puntos o departamentos que dependen
de él de forma jerárquica. Por lo tanto el borrado se aplica a uno o varios puntos.
2.5.2 Atributos
Nombre
CODINTERLOCU
TOR
Propósito
Código de departamento que se da de baja.
2.5.3 Ejemplo XML
<NOTIFICACION_GEFACTURA
REFERENCIA="201107181451404327501594"
ORIGEN="ESS55478996"
DESTINO="ESA1234567"
FECHA="2011-07-18T14:51:40.432"
DOMINIOORIGEN="S4611001A" >
<BAJA_DEPTO
CODINTERLOCUTOR="G100001499" />
</NOTIFICACION_GEFACTURA>
M/
O
M
Tipo
String
2.6 MODIFICA_PO.
2.6.1 Propósito
Este grupo de elementos se utiliza para informar de la modificación de un punto
operacional o departamento que ya existe en la libreta. Se informan todos los campos
que conforman el departamento, incluido el que cambia. No se especifica cual de
todos ellos es el que ha cambiado.
2.6.2 Atributos
Nombre
Propósito
M/
O
M
Tipo
String
CODINTERLOCUTOR
Código de departamento del que se
informa.
PADRE
Código
departamento
nodo
raíz
(entidad) al que pertenece el punto del
que se informa.
M
String
NOMBRE
Nombre del departamento del que se
informa.
M
String
DOMICILIO
Domicilio del departamento del que se
informa.
M
String
POBLACION
Población del departamento del que se
informa.
M
String
CP
CP del departamento del que se
informa.
M
String
PROVINCIA
Provincia del departamento del que se
informa.
M
String
PAIS
País del departamento del que se
informa.
Formato Alpha-2
M
String
NIF
NIF del departamento del que se
informa.
O
String
GV_TIPODESTINATARIO
Tipo de departamento:
M
String
RF = Receptor de facturas.
RM = Receptor de mercancías.
RFM = Receptor de facturas
mercancías.
NR = No receptor.
y
GV_CODIGOJERARQUICO
Código Jerárquico del departamento del
que se informa en el árbol de nodos de
la plataforma geFactura.
M
String
ES_CONTACTO
Persona de contacto del departamento
del que se informa.
O
String
2.6.3 Ejemplo XML
<NOTIFICACION_GEFACTURA
REFERENCIA="201108121237047674645904"
ORIGEN="ESS55478996"
DESTINO="ESA1234567"
FECHA="2011-08-12T12:37:04.767"
DOMINIOORIGEN="S4611001A" >
<MODIFICA_PO
CODINTERLOCUTOR="G11SGGFR"
PADRE="ESS55478996"
NOMBRE="SERVICIO PRINCIPAL DE FACTURACION"
DOMICILIO="C/PRINCIPAL, 32"
POBLACION="VALENCIA"
CP="46004"
PROVINCIA="VALENCIA"
PAIS="ES"
NIF=""
GV_TIPODESTINATARIO="RFM"
GV_CODIGOJERARQUICO="ESS55478996.G11.G11SGGFR"
ES_CONTACTO="Contacto" />
</NOTIFICACION_GEFACTURA>
2.7 SINCRO_PO.
2.7.1 Propósito
Este grupo de elementos se utiliza para la sincronización completa de la libreta de
direcciones de la GVA. Se envía periódicamente para actualizar los puntos o departamentos
que forman su estructura. De esta forma se publica todo el árbol que componen la libreta de la
GVA.
Actualmente, la GVA envía una vez al día la sincronización de todos sus puntos.
2.7.2 Atributos SINCRO_PO
Nombre
Propósito
CODINTERLOCUTOR
Punto operacional físico que se sincroniza.
M/
O
M
Tipo
String
2.7.3 Elementos
Nombre
PO
Propósito
Punto operacional lógico que se sincroniza, con
toda la información necesaria.
M/
O
M
Tipo
String
2.7.4 Atributos PO
Nombre
Propósito
M/
O
M
Tipo
String
CODINTERLOCUTOR
Código de departamento del que se
informa.
PADRE
Código del departamento raíz (entidad)
al que pertenece el punto del que se
informa.
M
String
NOMBRE
Nombre del departamento del que se
informa.
M
String
DOMICILIO
Domicilio del departamento del que se
informa.
M
String
POBLACION
Población del departamento del que se
informa.
M
String
CP
CP del departamento
informa.
se
M
String
PROVINCIA
Provincia del departamento del que se
informa.
M
String
PAIS
País del departamento del que se
informa.
Formato Alpha-2
M
String
NIF
NIF del departamento del que se
informa.
O
String
GV_TIPODESTINATARIO
Tipo de departamento:
M
String
del que
RF = Receptor de facturas.
RM = Receptor de mercancías.
RFM = Receptor de facturas
mercancías.
NR = No receptor.
y
GV_CODIGOJERARQUICO
Código Jerárquico del departamento del
que se informa en el árbol de nodos de
la plataforma geFactura.
M
String
ES_CONTACTO
Persona de contacto del departamento
del que se informa.
O
String
2.7.5 Ejemplo XML
<NOTIFICACION_GEFACTURA
REFERENCIA="2011092204020581273178713"
ORIGEN="ESS55478996"
DESTINO="ESA1234567"
FECHA="2011-09-22T04:02:05.812"
DOMINIOORIGEN="S4611001A" >
<SINCRO_PO
CODINTERLOCUTOR="ESS55478996">
<PO CODINTERLOCUTOR="G1601"
PADRE="ESS55478996"
NOMBRE="AGENCIA DE FACTURACION"
DOMICILIO="PL MAYOR, PISO PTA. 7"
POBLACION="VALENCIA"
CP="46005"
PROVINCIA="VALENCIA"
PAIS="ES"
NIF="Q323423423"
GV_TIPODESTINATARIO="RFM"
GV_CODIGOJERARQUICO="ESS55478996.G16.G1601"
ES_CONTACTO="Carlos" />
<PO CODINTERLOCUTOR="G1152"
PADRE="ESS55478996"
NOMBRE="FACTURACION"
DOMICILIO="C ALICANTE, 12. PISO PTA. 7"
POBLACION="VALENCIA"
CP="46005"
PROVINCIA="VALENCIA"
PAIS="ES"
NIF="A578765489"
GV_TIPODESTINATARIO="RFM"
GV_CODIGOJERARQUICO="ESS55478996.G16.G1152"
ES_CONTACTO="Carlos" />
…
</SINCRO_PO>
</NOTIFICACION_GEFACTURA>