• Author / Uploaded
• Juan MaRo

• Categories
• Jabón
• Red mundial
• Tecnología
• Software
• Internet

Citation preview

Recepción Factura Electrónica Guía de Implementación

Septiembre de 2011

HEB – Recepción Factura Electrónica Guía de Implementación

Contenido I.- Objetivo .................................................................................................................................................. 3 II.- Propósito................................................................................................................................................ 3 III.- Alcance .................................................................................................................................................. 3 IV.- Fuera de alcance................................................................................................................................... 4 V.- Definiciones, acrónimos y abreviaciones .............................................................................................. 4 VI.- Servicio Web del canal de Factura Electrónica de HEB ........................................................................ 5 1. Operaciones disponibles ..................................................................................................................... 5 2. URL del servicio web ........................................................................................................................... 5 VII.- Seguridad del servicio web .................................................................................................................. 6 VIII.- Validaciones Aplicables a CFD y CFDI ................................................................................................. 6 IX.- Estructura de Mensajes ........................................................................................................................ 8 1. Operación getIntegrationNumber ................................................................................................... 8 2. Operación getPurchaseOrder .......................................................................................................... 8 3. Operación getSheetDifferences ...................................................................................................... 8 4. Operación getReceiptNumber ......................................................................................................... 9 5. Operación getMessage .................................................................................................................... 9 6. Operación setDigitalInvoice............................................................................................................. 9 X.- Invocación de Servicio Web del Canal HEB para Factura Electrónica ................................................. 10 XI.- Anexos ................................................................................................................................................ 11 1. Descripción de Errores ...................................................................................................................... 11 XII.- Historial de cambios. ......................................................................................................................... 12

Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene información de uso interno, considérese como herramienta de trabajo.

2

HEB – Recepción Factura Electrónica Guía de Implementación

I.-

Objetivo

Describir las especificaciones y estándares para la implementación de los servicios web (WS) que permitan el intercambio de documentos electrónicos, tales como facturas electrónicas en sus formatos CDF y CDFI; órdenes de compra; folios de integración y de recepción; así como la hoja de diferencias. Proveer a los proveedores de HEB de un mecanismo mediante el cual se facilite la consulta de las órdenes de compra asignadas a este, así como el envío de las facturas generadas durante un determinado período. Los servicios proveerán de independencia a HEB en las comunicaciones con sus proveedores. Así mismo, el modelo arquitectónico, aportará funcionalidad, escalabilidad y seguridad. Las características de los servicios son las siguientes: Servicios web reutilizables, los cuales estarán expuestos para el uso de los proveedores de HEB para la recepción y consulta de documentos como órdenes de compra, folio de recepción, Hoja de diferencia y la integración de folios, así como facturas electrónicas y el acuse de recibo de estas. De acuerdo a necesidades futuras, algunos de los servicios web podrían servir de base para la generación de nuevos servicios web que podrían ser expuestos a usuarios externos de HEB. El intercambio de información deberá hacerse usando mecanismos que garanticen la seguridad e integridad de los datos intercambiados. Estandarización en el modelo de comunicación de HEB con sus proveedores y viceversa.

II.-

Propósito

El propósito fundamental del documento es el describir el uso correcto de cada uno de las operaciones descritas en el WSDL de los servicios web expuestos por Supermercados Internacionales HEB para el intercambio de documentos con sus Proveedores o Acreedores.

III.-

Alcance

El documento contempla entre sus alcances: Descripción de uso de los servicios web. Descripción de las estructuras de mensajes de entrada y salida para cada una de las operaciones que componen a los servicios web expuesto por Supermercados Internacionales HEB. Recomendaciones generales para el uso de los servicios web. Descripción del uso del complemento detallista, esquema definido por el SAT, como medio para el envío de la información complementaria requerida por Supermercados Internacionales HEB.

Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene información de uso interno, considérese como herramienta de trabajo.

3

HEB – Recepción Factura Electrónica Guía de Implementación

IV.-

Fuera de alcance

El documento no contempla entre sus alcances: Descripción de los esquemas con las estructuras del Comprobante Fiscal Digital ni del Comprobante Fiscal Digital por Internet, mayor ello deberá acceder la pagina de Servicio de Administración Tributaria (SAT) mediante link http://www.sat.gob.mx. Políticas, reglas y acuerdos operativos o comerciales entre Supermercados Internacionales HEB y sus Proveedores o Acreedores. Modelo de cliente en lenguaje de programación específico, para el uso de los servicios web.

V.-

Definiciones, acrónimos y abreviaciones Acrónimo o Término CFD CFDI WS

Descripción Comprobante Fiscal Digital Comprobante Fiscal Digital por Internet Web Service

Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene información de uso interno, considérese como herramienta de trabajo.

4

HEB – Recepción Factura Electrónica Guía de Implementación

VI.- Servicio Web del canal de Factura Electrónica de HEB 1. Operaciones disponibles Operación

Servició

Integración de Folio

getIntegrationNumber

Hoja de Diferencias

getSheetDifferences

Recepción de Factura

setDigitalInvoice

Órdenes de Compra

getPurchaseOrder

Folios de Recibo

getReceipNumbre

Mensaje

getMessage

Descripción Servicio que devuelve la información conciliada de los Folios Servicio que devuelve las diferencias en las entregas. Servicio que recibe la factura electrónica Servicio que devuelve las órdenes de compra. Servicio que devuelve los folios de recibo. Servicio de prueba para probar comunicación.

Estas operaciones están disponibles en los servicios web expuestos versiones cdfv2-cfdv3 versiones cfdv2.2-cfdv3.2.

A continuación se anexan las definiciones de los WSDL:

2. URL del servicio web A continuación se anexan las URL de los servicios web de afiliación.

https://recepcionfe.heb.com.mx:9087/MexicoDigitalInvoiceService?wsdl (cfdv2 y cfdv3) https://recepcionfe.heb.com.mx:9091/MexicoDigitalInvoiceService?wsdl (cfdv2.2 y cfdv3.2)

Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene información de uso interno, considérese como herramienta de trabajo.

5

HEB – Recepción Factura Electrónica Guía de Implementación

VII.- Seguridad de los servicios web Referente al tema de la seguridad se validara la autenticación y la encriptación del canal de comunicación con al WS. Para la autenticación se utilizo Security Token del tipo UserNameToken. Para la encriptación se utilizaran certificados de seguridad mismos que proporcionara HEB.

VIII.- Validaciones Aplicables a CFD y CFDI Para que las CFD y CFDI puedan ser aceptadas por HEB, se deben cumplir con varios requisitos, tanto administrativos y fiscales. En esta sección se describirán las validaciones generales aplicadas a dichos documentos para determinar si serán aceptados o rechazados. 1. El CFD y CFDI debe de apegarse a los lineamientos requeridos por la SAT. 2. El CFD y CFDI debe de contener un complemento conocido para HEB. 3. Validaciones fiscales para CFD a) Razón social y RFC del emisor. b) Razón social y RFC del receptor. c) Folio de la factura. d) Certificado, número y fecha de aprobación del emisor. e) Sello digital del emisor 4. Validaciones fiscales para CFDI f) Razón social y RFC del emisor g) Razón social y RFC del receptor h) Folio de la factura i) Certificado, numero y fecha de aprobación del emisor j) Sello digital del emisor k) Sello digital del validador (tercero autorizado) 5. Reglas administrativas sobre el complemento. a) Si en el complemento se cuenta con información de la Orden de Compara se validaran lo siguiente: i. Se validar las unidades ordenadas en OC contra las de la Factura. ii. Si las unidades ordenadas en OC son mayor o iguales a las unidades facturadas, se validar el código de barras. 1. Si las unidades ordenadas en OC son menor a las unidades facturadas, se rechazar e informara el error.

Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene información de uso interno, considérese como herramienta de trabajo.

6

HEB – Recepción Factura Electrónica Guía de Implementación

iii. Si el código de barras es válido y vigente, Se validar los artículos ordenados en OC contra los de la Factura. 1. Si el código de barras no es válido o vigente, se rechazara y se notificar el error. iv. Si los artículos ordenados en OC son mayores o iguales a los artículos facturados, notificar validez. 1. Si los artículos ordenados en OC son menor a las unidades facturadas, se rechazara e informara el error. b) Si en el complemento se cuenta con información de los folio de recepción se validaran lo siguiente: i. Se validar las unidades recibidas contra las de las Facturadas. ii. Si las unidades recibidas son mayor o iguales a las unidades facturadas, se validar los códigos de barras. 1. Si las unidades ordenadas en la OC son menores a las unidades facturadas, se rechazar e informara el error. iii. Si el código de barras es válido y vigente, se validar los artículos recibidos contra los Facturados. iv. Si los artículos recibidos son mayores o iguales a los artículos facturados, se validar si el documento es original o copia. 1. Si artículos recibidos son menor a los artículos facturados, se rechazar y se informar el error. v. Si el documento es original, se enviara el valor del campo de la factura. vi. Si el documento es una copia, se enviara el valor del campo de la orden de compra. c) Si en el complemento trae ambos documentos aplicar reglas del paso 5.b. i. Si no trae ningún documento asociado, se rechazara y se informara el error. d) Si no pasa las reglas de negocio, se rechazara y se informara el error.

Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene información de uso interno, considérese como herramienta de trabajo.

7

HEB – Recepción Factura Electrónica Guía de Implementación

IX.- Estructura de Mensajes A continuación se anexa la estructura conceptual de cada una de las operaciones con que el servicio cuenta. 1. Operación getIntegrationNumber

2. Operación getPurchaseOrder

3. Operación getSheetDifferences

Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene información de uso interno, considérese como herramienta de trabajo.

8

HEB – Recepción Factura Electrónica Guía de Implementación

4. Operación getReceiptNumber

5. Operación getMessage

6. Operación setDigitalInvoice

Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene información de uso interno, considérese como herramienta de trabajo.

9

HEB – Recepción Factura Electrónica Guía de Implementación

X.- Invocación de Servicio Web del Canal HEB para Factura Electrónica Para la invocación y resultados, es importante resaltar que al ser un Servicio Web, toda invocación se realiza mediante un mensaje SOAP, los documentos XML que aquí se describen deberán contenerse dentro del segmento de dicho mensaje. A continuación se describe (en términos generales) la invocación del Servicio Web. Debido a que éste es un servicio que cumple con las especificaciones de w3c (http://www.w3.org/standards/webofservices/) la invocación puede variar dependiendo de la plataforma desde la cual se desarrolle el cliente (i.e..NET, Java, php, etc.), por ejemplo, en los siguientes URL’s se podrá consultar la forma en que se puede invocar un Web Service desde diferentes plataformas: Invocando un Web Service desde Java. http://www.ibm.com/developerworks/webservices/library/ws-javaclient/index.html Invocando un Web Service desde PHP. http://php.net/manual/en/book.soap.php

Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene información de uso interno, considérese como herramienta de trabajo.

10

HEB – Recepción Factura Electrónica Guía de Implementación

XI.- Anexos 1. Descripción de Errores En esta sección podrá encontrar un listado de los errores que puede obtener al enviar un CFD y CFDI a los Web Services de HEB, así como algunos comentarios en cada uno de los errores. Código

Descripción error

INF0001

PROVEEDOR NO AFILIADO A FE

INF0002

PROVEEDOR INACTIVO

INF0003

NO TIENE DOCUMENTOS PENDIENTES

ERR0001

RFC DEL RECEPTOR NO VALIDO

ERR0100

RFC DEL EMISOR NO VALIDO

ERR0103

PAC NO VALIDO

ERR0104

CERTIFICADO DE FACTURA NO VALIDO

ERR0105

FOLIO DE FACTURA NO VALIDO

ERR0200

NO TIENE DOCUMENTOS RELACIONADOS

ERR0201

NO SE PUEDE FACTURAR MAS UNIDADES QUE LO ORDENADO

ERR0202

EL CODIGO DE BARRAS NO EXISTE

ERR0204

NO SE PUEDE FACTURAR MAS ARTICULOS QUE LO ORDENADO

ERR0205

NO SE PUEDE FACTURAR MAS UNIDADES QUE LO RECIBIDO

ERR0206

NO SE PUEDE FACTURAR MAS ARTICULOS QUE LO RECIBIDO

ERR0207

CODIGO DE BARRAS ES INVALIDO

ERR0208

FOLIO DE ORDEN DE COMPRA NO EXISTE

ERR0209

FOLIO DE RECIBO NO EXISTE

ERR9001

RANGO DE FECHAS INVALIDO - FECHA FINAL NO PUEDE SER MENOR QUE FECHA INICIAL

ERR9002

RANGO DE FECHAS INVALIDO

INF0004

BURO NO ESTA AFILIADO A FACTURA ELECTRONICA

ERR0300

PROVEEDOR NO ESTA AFILIADO AL BURO

ERR0301

REGISTRO DE BURO INACTIVO

INF0005

DOCUMENTO VALIDO FISCALMENTE

INF0006

DOCUMENTO NO VALIDO FISCALMENTE

INF0000

DOCUMENTO VALIDO

INF0007

DOCUMENTO CFO VALIDO

ERR0400

MENSAJE CONTIENE DISTINTOS RFCs

Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene información de uso interno, considérese como herramienta de trabajo.

11

HEB – Recepción Factura Electrónica Guía de Implementación

XII.- Historial de cambios. La presente tabla muestra el historial de los cambios que ha tenido el presente documento a raíz de su creación.

Versión 1.0 1.1 2.0

Fecha 04/05/2011 06/05/2011 19/06/2012

Descripción Creación Modificar Se agregan comentarios para el uso del nuevo web service que se utiliza en las nuevas versiones cfdv2.2 y cfdv3.2

Autor César Fernández Delgado Jesús M. Arroyo Tobías. Jorge Leon Antonio Hernández González

Este documento es propiedad de Supermercados Internacionales HEB, S.A. de C.V. Copyright (C) 2011. Todos los derechos reservados. Queda prohibida la copia parcial o total de este documento. Este documento contiene información de uso interno, considérese como herramienta de trabajo.

12