355a de soluciones cxml - help.sap.com

430
PUBLIC (PÚBLICO) 2022-06 Guía de soluciones cXML Ariba Network © 2022 SAP SE o una empresa filial de SAP. Reservados todos los derechos. THE BEST RUN

Upload: others

Post on 23-Jul-2022

5 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: 355a de soluciones cXML - help.sap.com

PUBLIC (PÚBLICO)2022-06

Guía de soluciones cXMLAriba Network

© 2

022

SAP

SE o

una

em

pres

a filial d

e SA

P. R

eser

vado

s to

dos

los

dere

chos

.

THE BEST RUN

Page 2: 355a de soluciones cXML - help.sap.com

Contenido

Guía de soluciones cXML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Ariba Network ahora forma parte de SAP Business Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14

Nuevos menús para la versión 2105. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15Cambios en la interfaz de usuario para compradores. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Cambios de interfaz de usuario para proveedores. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Introducción a las soluciones cXML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Uso recomendado de cXML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Acerca de la asignación de datos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Tamaño máximo de documentos y adjuntos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Acerca de las versiones cXML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Convenciones de datos cXML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Formato de números. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24Elemento Money. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Formato de dinero. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Atributos alternateCurrency y alternateAmount. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Elemento UnitOfMeasurement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26Formatos de nombre. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28Elemento PostalAddress. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Múltiples líneas en el elemento Street. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Elementos Country, State y PostalCode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Elemento TelephoneNumber. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Elemento CountryCode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Elementos AreaOrCityCode y Number. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Formato de fecha y hora. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Atributo de marca de tiempo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Tratamiento de los caracteres especiales en los documentos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Elementos extrínsecos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Direccionamiento y seguridad de documentos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Resumen de la seguridad del documento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Cifrado de documentos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Autentificación de documentos cXML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Conexiones HTTPS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36HTTPS para organizaciones compradoras. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

2PUBLICPÚBLICO

Guía de soluciones cXMLContenido

Page 3: 355a de soluciones cXML - help.sap.com

Cómo verificar URL en cuentas de Ariba Network (sitios de PunchIn de facturación colaborativa). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37HTTPS para proveedores y proveedores de servicios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37Cómo activar HTTPS en servidores Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Cómo verificar URLs en la cuenta de Ariba Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Autentificación de documentos cXML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Métodos de autentificación disponibles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Instalación de la autentificación de certificados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Cómo instalar el certificado en Ariba Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Cambio de sus URL Ariba Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Autenticación del certificado de Ariba Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Certificados digitales. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41Resumen de certificados digitales. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Certificados de cliente y de servidor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Autoridades de certificados de confianza. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42Intensidad de cifrado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Nombre de dominio en certificados de servidor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Cómo obtener un certificado digital. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43

Acerca de credenciales cXML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Dominios de ID soportados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44Credenciales múltiples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45Diferenciación entre mayúsculas y minúsculas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47Cambios de dominio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47ID de Ariba Network y versiones anteriores de Ariba Buyer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47Elemento DigitalSignature. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Cuentas de prueba. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Credenciales obligatorias. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Credenciales Ariba Buyer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Ariba Marketplace, Standar Edition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Proveedores de servicios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Credenciales de proveedor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Integración de extremos con adaptadores Ariba Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Configuración de un parámetro de configuración de extremo para los adaptadores de Ariba Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58Cómo activar la integración de extremos para documentos salientes. . . . . . . . . . . . . . . . . . . . . . . . 58Activación de la integración de extremo para Ariba Network Adapter for SAP NetWeaver. . . . . . . . . . 59Integración de extremos en una configuración ERP múltiple. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Activación rápida. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Utilización de pedidos de compra. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Utilización de facturas ICS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63Utilización de propuestas de pago. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Utilización de facturas CC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67

Guía de soluciones cXMLContenido

PUBLICPÚBLICO 3

Page 4: 355a de soluciones cXML - help.sap.com

Utilización de solicitudes de oferta. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69Utilización de los ID fiscales. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71

Transacción Perfil. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Uso de la transacción de perfil. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Envío de documentos ProfileRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73Recepción de documentos ProfileRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Elemento de credencial From. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Frecuencia de consultas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Documento ProfileRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Documento ProfileResponse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Consejos de implementación y restricciones para ProfileResponse. . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

URL HTTPS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78Opciones para OrderRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78URL de prueba de Ariba Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78

Planificación de sitios PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79PunchOut frente a catálogos estáticos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Jerarquía de catálogo y artículos en línea de solicitud de compra. . . . . . . . . . . . . . . . . . . . . . . . . . . 79Decidir si utilizar PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

Metodología de implementación del sitio PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80Planificación de un sitio PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

Análisis de estados actuales y futuros. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Externalización frente a desarrollo de sitio PunchOut interno. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81Participantes clave para integración PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Soporte necesario para determinar el nivel del sitio PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

Diseño del sitio PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Requisitos del sitio PunchOut de proveedor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Requisitos del sitio PunchOut de cliente. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84Más información acerca de cXML y PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Desarrollo del sitio PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86Flujo de mensajes PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86Extrínsecos y cookies de proveedor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88

Prueba del sitio PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88Autoevaluación del sitio PunchOut en Ariba Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88Evaluación del sitio PunchOut con clientes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Despliegue del sitio PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Gestión de configuración. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Servicio de atención al cliente. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90Verificación de plausibilidad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

Adecuación de un sitio Web existente. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Cómo aprovechar un sitio existente. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

4PUBLICPÚBLICO

Guía de soluciones cXMLContenido

Page 5: 355a de soluciones cXML - help.sap.com

Adecuación rápida. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91PunchOut para servicios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

Intercambio de servicios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92Creación de sesión. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92Sesión de edición. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

Cómo escribir una guía de despliegue PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93Resumen de la conectividad de un sitio PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93Identificación y autentificación de un sitio PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .94Extrínsecos requeridos del sitio PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94Especificación/Requisitos de contenido del sitio PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94Información de dirección del sitio PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .94Estructura de contabilidad del sitio PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95Descripción del código de mercancía del sitio PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96Transacciones admitidas del sitio PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96

Transacciones PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Catálogo de índice PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98

Elemento SupplierID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99Elemento URL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99Elemento Classification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99Atributo punchoutLevel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99Archivo de índice de PunchOut de ejemplo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

Documento PunchOutSetupRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Elementos de credencial. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Elemento UserAgent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102Atributo operation PunchOutSetupRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102Elemento BuyerCookie. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103Elementos extrínsecos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103Elemento BrowserFormPost. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104Elemento SupplierSetup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104Elemento SelectedItem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104Documento PunchOutSetupRequest de ejemplo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105

Documento PunchOutSetupResponse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106Resumen de los documentos PunchOutSetupResponse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106Elemento Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106Elemento URL StartPage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106Documento PunchOutSetupResponse de ejemplo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107

Documento PunchOutOrderMessage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107Atributo operationAllowed. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108cxml-base64 y cxml-urlencoded. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108Elemento BuyerCookie. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109Elemento Total. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109

Guía de soluciones cXMLContenido

PUBLICPÚBLICO 5

Page 6: 355a de soluciones cXML - help.sap.com

Elemento ItemIn. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109Elemento ItemID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110Elemento ItemDetail. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Documento PunchOutOrderMessage de ejemplo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

URL de PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115URL especificada en el sitio PunchOut del proveedor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115URL especificada en Ariba Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116URL especificado en el catálogo de índice del proveedor (obsoleto). . . . . . . . . . . . . . . . . . . . . . . . . 116

Elementos URL frente a SelectedItem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117PunchOut de nivel 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

Visualización y búsqueda de artículos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118Mecanismo del PunchOut de nivel 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118Mecanismo de sesión de compras en curso de PunchOut de nivel 2. . . . . . . . . . . . . . . . . . . . . . . . .119Formato de PunchOut de nivel 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

Requisitos de PunchOut de nivel 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122Requisitos de contenido del índice CIF y cXML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122Requisitos del sitio PunchOut de nivel 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

Ejemplos de catálogos de índice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123Catálogo de índice PunchOut a nivel de tienda. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .124Catálogo de índice PunchOut de nivel 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124PunchOutSetupRequest resultante. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125Catálogo de índice PunchOut de nivel 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

PunchOut a nivel de estantería. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127Carga de catálogos de índice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127Tiempo límite para sesiones PunchOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128Ejemplos ASP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

receivePunchoutSetupRequest.asp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129resolveXML.asp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130TCcXMLFormatDTime.asp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131

Adjuntos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133Adjuntos en Ariba Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .133Nombres de archivo para adjuntos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134Adjuntos y escaneo antivirus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134Extrínseco AttachmentOnline. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

Solicitudes de compra. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136Importación de solicitudes de compra. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .136Importación de una nueva solicitud de compra. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .136Actualización de una solicitud de compra. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139Cancelación de una solicitud de compra. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

Pedidos de compra. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

6PUBLICPÚBLICO

Guía de soluciones cXMLContenido

Page 7: 355a de soluciones cXML - help.sap.com

Enrutamiento del pedido en Ariba Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142Elemento OrderRequestHeader. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

ShipTo, BillTo y sus elementos secundarios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148Elemento BusinessPartner. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154Elemento TermsofDelivery. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155Elemento Tax. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156Elemento Modifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158Elemento Distribution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .160Elemento Accounting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160Elemento ControlKeys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162Elemento AccountingSegment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163Elemento Segment (en desuso). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164Campos de contabilidad en SAP Ariba Invoice Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164Tipos de recepción en SAP Ariba Invoice Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .165Integración ReceivingType con sistemas externos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166Elemento BlanketItemDetail. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166BlanketItemDetail en pedidos de compra globales. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166BlanketItemDetail en pedidos de compra de servicios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

Elemento ItemOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .168Valores de enmascaramiento en pedidos de compra. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

Enmascaramiento a nivel de cabecera y a nivel de línea. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175Extrínseco AmountBasedReceiving. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176Extrínseco ContingencyReceiving. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176Extrínseco InformationReceiving. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177Atributo de Currency de Money. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177Elemento de modificaciones. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177Elemento TermsofDelivery. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .178Elemento PriceBasisQuantity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178Elemento Tolerancias. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178Elemento ScheduleLine. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180Asignación de código de divisa de Ariba Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

Pedidos de cancelación y pedidos de cambio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182Requisitos de pedidos de cancelación y de cambio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182Requisitos de pedidos de cancelación y de cambio para organizaciones compradoras. . . . . . . . . . . 182Requisitos de pedidos de cancelación y de cambio para proveedores. . . . . . . . . . . . . . . . . . . . . . . 183Pedidos de cancelación y cambio y estado de pedido. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183Coincidencia de pedidos de compra. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183Pedidos de cancelación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

Pedidos de cambio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185Pedidos de cambio en Ariba Buyer 8.0 y anteriores. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185Pedidos de cambio en Ariba Buyer 8.1 y posteriores. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .185

Guía de soluciones cXMLContenido

PUBLICPÚBLICO 7

Page 8: 355a de soluciones cXML - help.sap.com

Consejos de implementación y restricciones para pedidos de compra. . . . . . . . . . . . . . . . . . . . . . . . . 186Elementos de credencial. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187Funciones de contacto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187Dirección Vendido a y NIF/CIF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188Ruta y copias de pedido. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188Divisiones de contabilidad para los pedidos de copia ERP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .189Artículos no incluidos en el catálogo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190Información introducida por el usuario para artículos por encargo. . . . . . . . . . . . . . . . . . . . . . . . . 190Activación o desactivación de pedidos por encargo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191Detección de pedidos por encargo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191Desglose de solicitudes en varias solicitudes de pedido. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191Grupos de artículos y artículos agrupados en pedidos de servicios. . . . . . . . . . . . . . . . . . . . . . . . . 191Hojas de entrada de servicios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192Tarjetas de compra. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .192Pedidos de compra global. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192Pedido de subcontratación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192Incoterms en pedidos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200Extrínseco AribaNetwork.PaymentTermsExplanation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

Órdenes de entrega basadas en plan de entrega. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202ReleaseInfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202ScheduleLineReleaseInfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203agreementType. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204ShipNoticePortion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

Artículos en línea de servicio planificada y sin planificar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205Artículos en línea de servicio planificados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205Artículos en línea de servicio sin planificar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208Líneas de servicio planificadas frente a líneas de servicio sin planificar. . . . . . . . . . . . . . . . . . . . . . 210Extrínsecos para enlaces en los que se puede hacer clic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211Extrínsecos para períodos de servicio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211Extrínseco para pedidos de compra heredados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212Cambios introducidos por Ariba Buyer 7.0.6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213Números de línea externa. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213Pedido de servicio con jerarquía multinivel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

Documentos de respuesta. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219Ejemplo de documento de respuesta. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .220Confirmaciones de pedido de compra. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220Otras formas de confirmar pedidos de compra. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221Confirmaciones de pedido de compra global. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221Documentos duplicados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .222Envío de mensajes de emisión a proveedores. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

Confirmaciones de pedidos y avisos de expedición. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .223

8PUBLICPÚBLICO

Guía de soluciones cXMLContenido

Page 9: 355a de soluciones cXML - help.sap.com

Visibilidad del estado del pedido. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .223Visibilidad del estado del pedido para organizaciones compradoras. . . . . . . . . . . . . . . . . . . . . . . . 223Visibilidad del estado del pedido para solicitantes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223Visibilidad del estado del pedido para proveedores. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

Ariba Network Configuración de cuenta. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224Configuración de cuenta de organizaciones compradoras. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224Configuración de cuenta de proveedor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .224

Flujo de transacciones Ariba Buyer 8.1 y posterior. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225Elemento ConfirmationRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225

Elemento ConfirmationHeader. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227Elemento OrderReference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229Elemento ConfirmationItem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229Elemento ConfirmationStatus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

Consejos de implementación y restricciones para documentos ConfirmationRequest. . . . . . . . . . . . . . 232Sustituciones de artículos en documentos ConfirmationRequest. . . . . . . . . . . . . . . . . . . . . . . . . . 232Confirmaciones y pedidos de servicio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232Confirmaciones y pedidos de cancelación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233Confirmaciones y pedidos de cambio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234Actualizaciones de confirmación del pedido. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234Envío de información de artículo en línea adicional con confirmaciones de pedido. . . . . . . . . . . . . . 235

Documentos OrderStatusRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241Elemento OrderStatusRequestHeader. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242Elemento OrderStatusRequestItem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242

Documentos ShipNoticeRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243Consejos de implementación y restricciones para ShipNoticeRequest. . . . . . . . . . . . . . . . . . . . . . 245Editar un aviso de expedición con cXML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .250Cómo cancelar un aviso de expedición mediante cXML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251

Hojas de entrada de servicios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .252Visibilidad del estado del pedido de la hoja de entrada de servicios. . . . . . . . . . . . . . . . . . . . . . . . . . . 252

Visibilidad del estado del pedido para organizaciones compradoras. . . . . . . . . . . . . . . . . . . . . . . . 252Visibilidad del estado del pedido para solicitantes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253Visibilidad del estado del pedido para proveedores. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

Configuración de la cuenta de Ariba Network para los documentos ServiceEntryRequest. . . . . . . . . . . 253Configuración de ServiceEntryRequest para organizaciones compradoras. . . . . . . . . . . . . . . . . . . 253Configuración de ServiceEntryRequest para proveedores. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

Documentos ServiceEntryRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254Consejos de implementación y restricciones para ServiceEntryRequest. . . . . . . . . . . . . . . . . . . . . 254Hojas de entrada de servicios generadas automáticamente. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256Hojas de entrada de servicios y pedidos de cancelación y cambio. . . . . . . . . . . . . . . . . . . . . . . . . . 257Ejemplo ServiceEntryRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .258

Actualizaciones de estado de ServiceEntryRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

Guía de soluciones cXMLContenido

PUBLICPÚBLICO 9

Page 10: 355a de soluciones cXML - help.sap.com

Solicitudes de oferta. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262Integración SAP Ariba Sourcing con SAP ERP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262

Documentos QuoteRequest para la integración SAP Ariba Sourcing. . . . . . . . . . . . . . . . . . . . . . . . 262Documentos QuoteMessage para la integración SAP Ariba Sourcing. . . . . . . . . . . . . . . . . . . . . . . .267

Automatización de ofertas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272Documento QuoteRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272Documento QuoteRequest de ejemplo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275Cancelación de solicitudes de oferta. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278

Integración de sourcing con Soluciones de SAP Ariba Procurement. . . . . . . . . . . . . . . . . . . . . . . . . . . 279Documentos QuoteRequest enviados por Soluciones de SAP Ariba Procurement. . . . . . . . . . . . . . .279Documentos QuoteMessage enviados a Soluciones de SAP Ariba Procurement. . . . . . . . . . . . . . . . 281

Facturas y pagos programados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285Funcionalidad de factura básica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285Coincidencia de pedidos de compra. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286

Coincidencia en Ariba Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286Coincidencias en Ariba Buyer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287

Reglas de negocio de facturación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287Reglas que sólo afectan a la conversión de PO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288Visibilidad de reglas de negocio de proveedor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288Validación numérica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .288

Consejos de implementación de facturas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289Firmas electrónicas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289Elemento IdReference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293Funciones de contacto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295Conversión de segmento en AccountingSegment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295Atributo payloadID de factura. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296Elemento ServiceEntryItemReference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296Elementos SerialNumber. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297Elemento PaymentTerm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297ID de envío. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298Abonos y abonos de artículo en línea. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298Verificación de facturas basada en el recibo de bienes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .299Atributo Fecha de inspección. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302Elemento PriceBasisQuantity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302Atributo itemType. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302Atributo compositeItemType. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303Elemento Tolerancias. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .306Categoría TaxDetail. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307Impuesto de expedición y manipulación especial. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307Deducciones o descuentos y cargos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309Impuestos parafiscales franceses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317

10PUBLICPÚBLICO

Guía de soluciones cXMLContenido

Page 11: 355a de soluciones cXML - help.sap.com

Soporte de retención fiscal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322Campos obligatorios para países con un sistema de IVA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323Facturas para proveedores de México. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328Elementos extrínsecos para facturas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332Longitudes de campo del elemento de factura. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345Adjuntos de copia de la factura en PDF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345

Transmisión de facturas a organizaciones de compras. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346Estado y cancelación de facturas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

Estado de factura. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347Cancelación de facturas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347

Ejemplo de factura de resumen (varios pedidos de compra). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348Factura de nivel de cabecera de ejemplo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351Factura de pedido de compra global de ejemplo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .354Ejemplo de un escenario comprador/proveedor complejo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357

Ejemplo de pedido de compra: Escenario comprador/proveedor complejo. . . . . . . . . . . . . . . . . . . 357Ejemplo de factura estándar: Escenario comprador/proveedor complejo. . . . . . . . . . . . . . . . . . . . 360Abono de ejemplo: Escenario comprador/proveedor complejo. . . . . . . . . . . . . . . . . . . . . . . . . . . .364Nota de débito de ejemplo: Escenario comprador/proveedor complejo. . . . . . . . . . . . . . . . . . . . . . 365Factura de cancelación de ejemplo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367

Pagos programados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368Pago EFT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368Gestión de descuentos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .369Ejemplo de pago programado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371

Recibos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .374Enrutamiento ReceiptRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374Documento ReceiptRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .374

ReceiptRequestHeader. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .375ReceiptOrder. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .376

Documento de recibo de ejemplo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380

Transacción de carga de catálogo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382Resumen de la transacción de carga de catálogo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382Requisitos previos de CatalogUpoadRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .383Documento CatalogUploadRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384

Elemento To. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384Elemento CatalogUploadRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385

Cómo adjuntar un catálogo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387Utilización de un sobre MIME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387Compresión de catálogos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388

Ejemplo de cómo enviar un documento CatalogUploadRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388Recepción de la respuesta. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389

Guía de soluciones cXMLContenido

PUBLICPÚBLICO 11

Page 12: 355a de soluciones cXML - help.sap.com

Recepción del estado de catálogo posterior. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390Notificación por correo electrónico de estado del catálogo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391Notificación URLPost de estado del catálogo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391

Negociaciones de financiación de la cadena de suministro. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .393

Transacción para obtener documentos pendientes/descargar datos. . . . . . . . . . . . . . . . . . . . . . 396Frecuencia de consulta. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396Hora de consulta. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .397Descarga de todos los documentos en espera. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397Confirmar la recepción de documentos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .397GetPendingRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398GetPendingResponse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400DataRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401DataResponse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401

DataResponse y archivos adjuntos de factura. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .402lastReceivedTimeStamp y documentos en espera. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403Autentificación de documentos en espera. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404

SAP Ariba Supply Chain Collaboration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405Colaboración de consignación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405

Ejemplo ConsignmentMovement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406Escenarios empresariales y premisas para la previsión y el compromiso B2B . . . . . . . . . . . . . . . . . . . 408

Contratos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410ContractRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410ContractStatusUpdateRequest. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415

Tranformaciones cXML en Ariba Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417Activación de transformaciones. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417Desplazamiento de extrínsecos al elemento Contact. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417Transformación de extrínsecos ItemOut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419Consolidación de ItemOut en OrderRequestHeader. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419Asignación de extrínsecos personalizados a extrínsecos de Ariba Network. . . . . . . . . . . . . . . . . . . . . .420Asignación de extrínsecos de cXML a EDI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420

Sistemas de codificación recomendados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422Códigos de mercancía. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .422Códigos de divisa. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423Códigos de unidad de medida. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423Códigos de estado y país. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424Códigos de idioma. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426Códigos de marcación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427

12PUBLICPÚBLICO

Guía de soluciones cXMLContenido

Page 13: 355a de soluciones cXML - help.sap.com

Guía de soluciones cXML

En esta guía se describen implementaciones específicas de aplicación de cXML para que sea compatible con las soluciones de compras, sourcing y facturación de SAP Ariba. Complementa la documentación de las DTD públicas cXML disponibles en cxml.org.

Esta guía se aplica a:

● Las soluciones en la nube de SAP Ariba

Guías relacionadas

Introducción a cXML

Guía de referencia de cXML

cXML Release Notes

Guía de soluciones cXMLGuía de soluciones cXML

PUBLICPÚBLICO 13

Page 14: 355a de soluciones cXML - help.sap.com

Ariba Network ahora forma parte de SAP Business Network

¿Qué es SAP Business Network?

SAP Business Network es una oferta de colaboración basada en la nube que puede ayudarle a transformar las cadenas de suministro desconectadas en redes unificadas, colaborativas e inteligentes que eliminan las barreras y centralizan los datos.

Con una red unificada, puede conectarse con todos los socios comerciales a través de un único directorio, colaborar utilizando datos y flujos de trabajo compartidos y aplicar un análisis de información en toda la red para guiar las decisiones y mejorar sus negocios.

¿Es SAP Business Network una red nueva o diferente?

No; SAP Business Network es el nuevo nombre de la solución para el portal del socio comercial que todos los proveedores Ariba Network utilizan como parte de la visión de red unificada de SAP. La red de transacciones detrás del portal sigue estando marcada como Ariba y se sigue operando por Ariba Inc. (una subsidiaria de propiedad total de SAP SE).

¿Qué se renombra exactamente a SAP Business Network y qué permanece como Ariba Network?

Se renombran dos experiencias de proveedor como SAP Business Network: la incorporación basada en invitación de solicitud de relación comercial para cuentas empresariales, y la página de inicio del proveedor y el panel de trabajo para todas las cuentas empresariales y estándar. Todas las demás experiencias de red permanecen con la marca Ariba Network o SAP Ariba Supply Chain Collaboration.

14PUBLICPÚBLICO

Guía de soluciones cXMLAriba Network ahora forma parte de SAP Business Network

Page 15: 355a de soluciones cXML - help.sap.com

Nuevos menús para la versión 2105

La Ariba NetworkBandeja de entrada y la Bandeja de salida se han sustituido por menús orientados a objetos para todos los compradores y proveedores. Ahora, los artículos de menú se agrupan de forma lógica por proceso y de este modo mejora la navegación y la capacidad de uso.

Cambios en la interfaz de usuario para compradores

El enlace Volver a la vista clásica ahora se muestra en la parte superior de cada página.

La tabla siguiente describe las vías de acceso de menú anteriores para los compradores y homólogos en los nuevos menús orientados a objetos.

Menú anterior Menú nuevo

Inicio Panel de instrucciones Inicio Panel de instrucciones

Inicio Seguimiento de la cadena de provisión Inicio Seguimiento de la cadena de provisión

Inicio Panel de instrucciones de la cadena de provisión

Inicio Panel de instrucciones de la cadena de provisión

Bandeja de entrada Facturas Facturas Facturas

Bandeja de entrada Verificación de la marca de tiempo

Facturas Verificación de la marca de tiempo

Bandeja de entrada Confirmación de pedido Cumplimiento Confirmaciones de pedido

Bandeja de entrada Avisos de expedición Cumplimiento Avisos de expedición

Bandeja de entrada Confirmaciones de transporte Cumplimiento Confirmaciones de transporte

Bandeja de entrada Hojas de entrada de servicios Cumplimiento Hojas de entrada de servicios

Bandeja de entrada Transacciones AP Plus Pagos Transacciones AP Plus

Bandeja de entrada Extracto de cuenta de tarjeta Pagos Extracto de cuenta de tarjeta

Bandeja de entrada Notificaciones Enlaces rápidos Notificaciones

Bandeja de entrada Facturas sin asignar Facturas Facturas sin asignar

Bandeja de entrada Facturas archivadas Facturas Facturas archivadas

Bandeja de entrada Cola pendiente Enlaces rápidos Cola pendiente

Guía de soluciones cXMLNuevos menús para la versión 2105

PUBLICPÚBLICO 15

Page 16: 355a de soluciones cXML - help.sap.com

Menú anterior Menú nuevo

Bandeja de entrada Pedidos de ventas Cumplimiento Pedidos de ventas

Bandeja de entrada Recibo de componentes Cumplimiento Colaboración ampliada

Bandeja de entrada Reaprovisionamiento de producto

Cumplimiento Reaprovisionamiento de producto

Bandeja de salida Pedidos y órdenes de entrega Para los compradores sin SAP Ariba Supply Chain Collabora­

tion: Pedidos Pedidos de compra

Para los compradores con SAP Ariba Supply Chain Collabora­

tion: Pedidos Pedidos y órdenes de entrega

Bandeja de salida Colaboración ampliada Cumplimiento Colaboración ampliada

Bandeja de salida Partes de horas y hojas de gastos Cumplimiento Partes de horas y hojas de gastos

Bandeja de salida Solicitudes de transporte Cumplimiento Solicitudes de transporte

Bandeja de salida Oportunidades de descuento Pagos Oportunidades de descuento

Bandeja de salida Pagos programados Pagos Pagos programados

Bandeja de salida Remesas Pagos Remesas

Bandeja de salida Recibos Cumplimiento Recepciones de bienes

Bandeja de salida Archivos de pagos programados Pagos Archivos de pagos programados

Bandeja de salida Lotes de pago Pagos Lotes de pago

Bandeja de salida Solicitudes de oferta Pedidos Solicitudes de oferta

Bandeja de salida Solicitudes de compra Pedidos Solicitudes de compra

Bandeja de salida Peticiones de información Pedidos Peticiones de información sobre pedido

Bandeja de salida Expediciones de componentes Cumplimiento Colaboración ampliada

Bandeja de salida Documentos para reenvío Enlaces rápidos Documentos para reenvío

Bandeja de salida Actividad de producto Enlaces rápidos Mensajes de actividad de producto

Calidad Revisión de calidad Calidad Revisar

Calidad Inspección de calidad Calidad Inspección

Calidad Aviso de calidad Calidad Notificación

Calidad Configuración de calidad Calidad Configuración

Planificación Previsión Planificación Previsión

Planificación Colaboración en la planificación Planificación Colaboración en la planificación

Planificación Capacidad Planificación Colaboración de capacidad

16PUBLICPÚBLICO

Guía de soluciones cXMLNuevos menús para la versión 2105

Page 17: 355a de soluciones cXML - help.sap.com

Menú anterior Menú nuevo

N/A Planificación Informe de ventas

Personalización Enlaces rápidos Personalización

Catálogos Catálogos

Activación de proveedores Gestionar suministradores

Activación de proveedores Gestionar suministradores

Activación de proveedores Relaciones activas Activación de proveedores Relaciones activas

Activación de proveedores Grupos de proveedores Activación de proveedores Grupos de proveedores

Activación de proveedores Contactos Activación de proveedores Contactos

Activación de proveedores Configurar Activación de proveedores Configurar

Activación de proveedores Cargar códigos de calidad Activación de proveedores Cargar códigos de calidad

Activación de proveedores Cargar códigos de pieza, planta y producto

Activación de proveedores Cargar códigos de pieza, planta y producto

Activación de proveedores Cargar códigos de transportista

Activación de proveedores Cargar códigos de transportista

Activación de proveedores Realizar seguimiento Activación de proveedores Realizar seguimiento

Activación de proveedores Tareas Activación de proveedores Tareas

Activación de proveedores Portal de información del proveedor

Activación de proveedores Portal de información del proveedor

Activación de proveedores Cargar suministradores Activación de proveedores Cargar suministradores

Administración Usuarios Administración Usuarios

Administración Configuración Administración Configuración

Administración Auditoría Administración Registro de auditoría

Administración Lista maestra Administración Lista maestra

Administración Volver a enviar documentos de copia Enlaces rápidos Documentos para reenvío

Administración Reemplazar socio Administración Reemplazar socio

Informes Informes

Archivo de documentos Documentos archivados Enlaces rápidos Documentos archivados

Archivo de documentos Estado de la descarga Enlaces rápidos Estado de la descarga

Descargas de archivos Enlaces rápidos Descargas de archivos

Mensajes Mensajes

Guía de soluciones cXMLNuevos menús para la versión 2105

PUBLICPÚBLICO 17

Page 18: 355a de soluciones cXML - help.sap.com

Cambios de interfaz de usuario para proveedores

La tabla siguiente describe las vías de acceso de menú anteriores para los proveedores y homólogos en los nuevos menús orientados a objetos.

Menú anterior Menú nuevo

Inicio Inicio

Bandeja de entrada Pedidos y órdenes de entrega Para los proveedores sin SAP Ariba Supply Chain Collabora­

tion: Pedidos Pedidos de compra

Para los proveedores con SAP Ariba Supply Chain Collabora­

tion: Pedidos Pedidos y órdenes de entrega

Bandeja de entrada Colaboración ampliada Cumplimiento Colaboración ampliada

Bandeja de entrada Solicitudes de colaboración Oportunidades Solicitudes de colaboración

Bandeja de entrada Partes de horas y hojas de gastos

Cumplimiento Partes de horas y hojas de gastos

Bandeja de entrada Solicitudes de transporte Cumplimiento Solicitudes de transporte

Bandeja de entrada Pronto pagos Pagos Pronto pagos

Bandeja de entrada Pagos programados Pagos Pagos programados

Bandeja de entrada Remesas Pagos Remesas

Bandeja de entrada Contratos Pedidos Contratos

Bandeja de entrada Notificaciones ... Notificaciones , en la sección Seguimiento.

Bandeja de entrada Recibos Cumplimiento Recepciones de bienes

Bandeja de entrada Cola pendiente ... Cola pendiente , en la sección Seguimiento.

Bandeja de entrada Actividad de producto ... Mensajes de actividad de producto , en la sección Seguimiento.

Bandeja de entrada Peticiones de información Pedidos Peticiones de información sobre pedido

Bandeja de salida Facturas Facturas Facturas

Bandeja de salida Verificación de la marca de tiempo Facturas Verificación de la marca de tiempo

Bandeja de salida Confirmaciones de pedido Cumplimiento Confirmaciones de pedido

Bandeja de salida Avisos de expedición Cumplimiento Avisos de expedición

Bandeja de salida Confirmaciones de transporte Cumplimiento Confirmaciones de transporte

Bandeja de salida Hojas de entrada de servicios Cumplimiento Hojas de entrada de servicios

18PUBLICPÚBLICO

Guía de soluciones cXMLNuevos menús para la versión 2105

Page 19: 355a de soluciones cXML - help.sap.com

Menú anterior Menú nuevo

Bandeja de salida Transacciones AP Plus Pagos Transacciones AP Plus

Bandeja de salida Facturas archivadas Facturas Facturas archivadas

Para borradores de avisos de expedición y hojas de entrada de

servicios, Bandeja de salida BorradoresCumplimiento Borradores

Bandeja de salida Pedidos de ventas Cumplimiento Pedidos de ventas

Bandeja de salida Conversión PDF Facturas Conversión PDF

Bandeja de salida Reaprovisionamiento de producto Cumplimiento Reaprovisionamiento de producto

Bandeja de salida Colaboración ampliada Cumplimiento Colaboración ampliada

Bandeja de salida Documentos para reenvío ... Documentos para reenvío , en la sección Seguimiento.

Catálogos Catálogos

Tareas de activación Activación

Informes Informes

Archivo de documentos Documentos archivados ... Documentos archivados , en la sección Archivo de documentos.

Archivo de documentos Estado de la descarga ... Estado de la descarga , en la sección Archivo de documentos.

Mensajes Mensajes

Planificación Previsión Planificación Previsión

Planificación Colaboración en la planificación Planificación Colaboración en la planificación

Planificación Informe de ventas Planificación Informe de ventas

Documentos ...

Documentos CSV de confirmación del pedido ... Confirmación de pedido , en la sección Carga CSV.

Documentos CSV de aviso de expedición ... Aviso de expedición , en la sección Carga CSV.

Documentos Plantillas CSV ... Plantillas , en la sección Descarga CSV.

Documentos CSV de factura ... Factura , en la sección Carga CSV.

Documentos Hoja de entrada de servicios CSV ... Hoja de entrada de servicios , en la sección Carga CSV

Documentos Factura PDF ... Factura PDF , en la sección Carga CSV.

Documentos Documento externo ... Documento externo , en la sección Carga CSV.

Documentos Factura de pedido Crear Factura de pedido

Documentos Factura sin pedido Crear Factura sin pedido

Guía de soluciones cXMLNuevos menús para la versión 2105

PUBLICPÚBLICO 19

Page 20: 355a de soluciones cXML - help.sap.com

Menú anterior Menú nuevo

Documentos Factura de contrato Crear Factura de contrato

Documentos Hoja de entrada de servicios Crear Hoja de entrada de servicios

Documentos Partes de horas y hojas de gastos Crear Partes de horas y hojas de gastos

Descargas de archivos ... Cargar/Descargar , en la sección Archivos de Excel.

Para borradores de factura, Bandeja de salidaBorradores

Facturas Borradores

Bandeja de salida Facturas , filtrar por Abonos Facturas Abonos

Bandeja de salida Facturas , filtrar por Notas de cargo Facturas Notas de cargo

20PUBLICPÚBLICO

Guía de soluciones cXMLNuevos menús para la versión 2105

Page 21: 355a de soluciones cXML - help.sap.com

Introducción a las soluciones cXML

Las aplicaciones SAP Ariba asignan datos a y desde documentos utilizando commerce eXtensible Markup Language (cXML). cXML es un idioma abierto definido por Document Type Definitions (DTDs). Los DTD definen cXML para que sea extremadamente flexible.

SAP Ariba proporciona directrices y recomendaciones de la solución cXML para complementar la descripción general de cXML proporcionada en la Guía de referencia de cXML disponible en http://www.cxml.org .

Uso recomendado de cXML [página 21]

Acerca de la asignación de datos [página 21]

Tamaño máximo de documentos y adjuntos [página 22]

Acerca de las versiones cXML [página 23]

Uso recomendado de cXMLLas aplicaciones de SAP Ariba utilizan una implementación específica del idioma cXML. Para interactuar correctamente con las aplicaciones de SAP Ariba mediante cXML, debe comprender el comportamiento cXML de estas aplicaciones.

Concretamente debe comprender y trabajar con el comportamiento cXML externo de Ariba Network y la solución de facturación o compras de SAP Ariba.

Acerca de la asignación de datoscXML es un idioma general para transmitir información relacionada con el comercio. Las organizaciones lo utilizan para comunicar datos de negocio entre varias aplicaciones a través de Ariba Network utilizando la asignación de datos.

Por ejemplo, los socios comerciales utilizan cXML para comunicar pedidos de compra. Cuando las organizaciones compradoras generan pedidos de compra cXML, incluyen datos de sus sistemas de planificación de recursos empresariales (ERP) y sistemas de compras. Orientan estos pedidos de compra a sus proveedores a través de Ariba Network. A continuación, los proveedores extraen datos de los pedidos de compra y los utilizan en sus sistemas de cumplimiento de pedidos.

Los sistemas back end de los socios comerciales deben poder asignar a o a partir de documentos cXML. Las configuraciones predeterminadas de estos sistemas externos no siempre tienen los datos o el formato necesarios para el protocolo cXML. Aunque los mensajes estén bien formados en cXML, los datos reales de estos elementos pueden variar. Esta inconsistencia afecta tanto a las organizaciones compradoras como a los proveedores, y esto puede provocar largos tiempos de integración.

Guía de soluciones cXMLIntroducción a las soluciones cXML

PUBLICPÚBLICO 21

Page 22: 355a de soluciones cXML - help.sap.com

Utilice las directrices y las recomendaciones de Ariba para implementar datos consistentes entre socios comerciales. Proporcionan prácticas recomendadas para la conversión de datos del sistema back end en cXML con el fin de evitar la variación de los datos transferidos entre socios comerciales.

Tamaño máximo de documentos y adjuntosTamaño máximo de los documentos

El tamaño máximo de un pedido cXML, un aviso de expedición, una confirmación de pedido o un documento de factura es de 40 MB o 10.000 artículos en línea. Todos los demás documentos cXML están limitados a un tamaño máximo de 4 MB o 1.000 artículos en línea. Estos máximos no incluyen el tamaño de los adjuntos.

Tamaño máximo de los adjuntos

El tamaño máximo de los adjuntos se refiere al tamaño total combinado de todos los adjuntos del mismo documento.

NotaDurante la carga de los adjuntos, los archivos adjuntos originales se convierten en texto ASCII sin formato, mediante la codificación base64. Esta conversión aumenta el tamaño del archivo en aproximadamente un 35 %. Por este motivo, el límite de tamaño de archivo real es el 65 % del límite máximo configurado.

Por ejemplo, si el límite máximo permitido está establecido en 10.000 KB (10 MB), el tamaño de archivo adjunto total real que pueden agregar los usuarios será de 6.500 KB. Si intenta cargar un adjunto que supera este límite, Ariba Network mostrará un error y no permitirá la carga.

Con la excepción de un tipo de documento, la opción predeterminada es 10 MB para el tamaño máximo de los adjuntos. La opción más alta posible es 100 MB.

Para los usuarios activados para el componente de colaboración de calidad en SAP Ariba Supply Chain Collaboration, un documento de revisión de calidad tiene un tamaño de adjunto máximo predeterminado de 100 MB. La opción más alta posible es 200 MB.

Para cambiar el tamaño máximo de los adjuntos, los compradores pueden pedir a su contacto de asistencia designado que registre una solicitud de servicio. Un representante del servicio de asistencia de SAP Ariba hace el seguimiento del cambio. El tamaño máximo de adjunto del comprador se aplica a todos los documentos que se envían entre ese comprador y sus proveedores.

Límites de tamaño en la interfaz de usuario de Ariba Network

La interfaz de usuario de Ariba Network no muestra ningún documento de más de 1 MB (o 2 MB para los compradores y proveedores habilitados para SAP Ariba Supply Chain Collaboration) o que tenga más de 1.000 artículos en línea.

22PUBLICPÚBLICO

Guía de soluciones cXMLIntroducción a las soluciones cXML

Page 23: 355a de soluciones cXML - help.sap.com

Si un documento supera el límite, solo podrá ver la cabecera del documento cuando lo abra; los detalles del artículo en línea no se mostrarán. Para revisar el documento completo, puede abrirlo y descargarlo en formato CSV. Si estos límites de tamaño impiden que la interfaz de usuario de Ariba Network gestione un documento, puede utilizar un método alternativo como el canal integrado.

Acerca de las versiones cXMLLas nuevas versiones de cXML se lanzan periódicamente a medida que cXML estándar mejora. Las aplicaciones habilitadas para cXML deben poder detectar la versión cXML de los documentos recibidos y procesarlos como corresponda.

Notificación de cambios cXML

SAP Ariba le informa acerca de las nuevas versiones cXML y de los cambios en el comportamiento cXML a través de Ariba Network y del servicio de asistencia de SAP Ariba. Busque en su cuenta de Ariba Network los avisos de las nuevas versiones cXML. Además, compruebe también que las direcciones de correo electrónico de notificación en su cuenta de Ariba Network estén actualizadas.

Referencias adicionales

● Notas de la versión cXML en http://www.cxml.org

Guía de soluciones cXMLIntroducción a las soluciones cXML

PUBLICPÚBLICO 23

Page 24: 355a de soluciones cXML - help.sap.com

Convenciones de datos cXML

Utilice convenciones de datos cXML para garantizar la consistencia de los datos entre múltiples socios comerciales. cXML proporciona convenciones de datos para números, elementos monetarios, unidades de medida, nombres, direcciones postales, números de teléfono, fechas y horas y elementos extrínsecos.

Formato de números [página 24]

Elemento Money [página 25]

Elemento UnitOfMeasurement [página 26]

Formatos de nombre [página 28]

Elemento PostalAddress [página 28]

Elemento TelephoneNumber [página 30]

Formato de fecha y hora [página 32]

Tratamiento de los caracteres especiales en los documentos [página 33]

Elementos extrínsecos [página 34]

Formato de números

La propuesta de datos XML de World Wide Web Consortium (W3C) define tipos de datos utilizados por cXML.

Encontrará más información sobre la propuesta de W3C en (http://www.w3c.org/TR/1998/NOTE-XML-data-0105) .

W3C proporciona la siguiente información sobre los datos numéricos:

“Un número, sea cual sea la cantidad de dígitos que tenga, puede ser positivo o negativo, tener decimales y, opcionalmente, un exponente. La puntuación es la correspondiente al inglés americano”.

Los números en cXML utilizan la “puntuación correspondiente al inglés americano”. Estas son otras restricciones y opciones:

● No deben incluirse símbolos como “$” o “%”.● Como separador decimal debe usarse el punto (.).● Opcional pueden utilizarse comas (,) como separadores de miles.● La notación científica no está permitida.

Ejemplos correctos:

<Discount>23</Discount> <Discount>4.01</Discount><Discount>3001.01</Discount> <Discount>3,001.01</Discount>

24PUBLICPÚBLICO

Guía de soluciones cXMLConvenciones de datos cXML

Page 25: 355a de soluciones cXML - help.sap.com

Ejemplos incorrectos:

<Discount>1.34%</Discount>

No debe incluirse el símbolo de porcentaje (%).

<Discount>1234,00</Discount>

El separador decimal debe ser un punto (.).

<Discount>123.567.890</Discount>

Los separados de miles son opcionales, pero si se utilizan deben ser comas (,).

Elemento MoneyEl elemento Money describe el formato de datos que se ha de utilizar para valores monetarios. También proporciona atributos para especificar una divisa e importe alternativos.

Ejemplo

<Money currency="USD">1.34</Money>

Especifique una divisa con un código de divisa ISO 4217 de tres letras. Encontrará una lista con estos códigos en Códigos de divisas [página 423].

Formato de dinero

cXML sigue la recomendación XML de W3C para utilizar la “puntuación correspondiente al inglés americano”. No deben incluirse símbolos de divisas, como por ejemplo “$.”

Ejemplos correctos:

<Money currency="USD">1234.00</Money> <Money currency="USD">1,234.00</Money>

Ejemplos incorrectos:

<Money currency="USD">$1.34</Money>

No debe incluirse el símbolo del dólar ($).

<Money currency="US dollar">1.34</Money>

Guía de soluciones cXMLConvenciones de datos cXML

PUBLICPÚBLICO 25

Page 26: 355a de soluciones cXML - help.sap.com

Código de divisa ISO incorrecto.

<Money currency="USD">1234,00</Money>

El separador decimal debe ser un punto (.).

NotaAunque “XXX” es un código de divisa válido en ISO 4217, Ariba Network no admite el uso de “XXX” como código de divisa.

Atributos alternateCurrency y alternateAmount

Para documentos cXML que afectan a países que utilizan distintas divisas puede necesitar incluir una divisa alternativa e información de importe.

cXML proporciona los atributos alternateCurrency y alternateAmount para esta información de divisa alternativa.

Ejemplo

<Money currency="USD" alternateCurrency=”EUR” alternateAmount=”14.28”>12.34 </Money>

También puede necesitar utilizar estos atributos para especificar una divisa “local” en facturas. Encontrará más información en NIF/CIF del comprador y del proveedor obligatorios [página 326].

Ariba Buyer 7.0 y posteriores implementan estos atributos.

Elemento UnitOfMeasurementUtilice los códigos de las unidades de medida de las Naciones Unidas (UNUOM) para describir cómo se empaquetan o entregan los artículos.

La siguiente tabla lista los códigos UNUOM más usados:

Código UNUOM Significado

EA cada (each)

BX caja (box)

DZN docena (dozen)

GRO bruto (gross)

HUR hora (hour)

26PUBLICPÚBLICO

Guía de soluciones cXMLConvenciones de datos cXML

Page 27: 355a de soluciones cXML - help.sap.com

Código UNUOM Significado

KGM kilogramo

LBR libra

M4 unidades monetarias

RO rollo

RL carrete (reel)

PR par

PK pack

Encontrará más información en Códigos de unidades de medida [página 423].

Ariba Network puede traducir documentos entre cXML y Electronic Data Interchange (EDI). Tanto cXML como EDI UN EDIFACT utilizan la norma UNUOM, de modo que Ariba Network no lleva a cabo ninguna traducción de códigos entre ambos. Sin embargo, EDI X12 utiliza la norma ANSI, lo que significa que Ariba Network tiene que traducir los códigos de unidades de medida. Algunos de estos códigos son los mismos en ambas normas, pero otros son diferentes y algunos aparecen en ambas normas pero hacen referencia a unidades de medida distintas.

Es fundamental que los socios comerciales utilicen códigos de unidades de medida idénticos. No utilice códigos de unidades de medida personalizados porque se desconoce cómo va a llevarse a cabo la traducción y eso puede dar lugar a códigos inapropiados.

Algunos de los problemas de asignación de unidades de medida que se han dado con frecuencia son los siguientes:

● Las organizaciones compradoras pueden querer indicar en los requisitos del trabajo "aprovechar al máximo el tiempo". Estas deberían implementar pedidos de compra para efectuar pedidos por hora (HUR) o por unidades de dinero (M4). El código M4 hace referencia a unidades monetarias tanto en la norma UNUOM como en la norma ANSI.

● Es posible que los socios comerciales quieran utilizar el código ilegal DOL o $ para indicar "dólares estadounidenses". Para medir artículos en unidades de dinero, utilice el código M4.

● Muchas organizaciones compradoras utilizan códigos de unidades de medida ANSI en sus sistemas internos. Si por accidente permiten que los códigos ANSI aparezcan en documentos cXML y Ariba Network traduce esos documentos a X12 EDI, algunos de esos códigos podrían funcionar pero otros darán lugar a datos incorrectos. Para evitar confusiones, en cXML deben utilizar códigos UNUOM.Por ejemplo el código RL hace referencia a "carrete" (reel) en UNUOM y a "rollo" (roll) en ANSI. Si una organización compradora indica por error en sus pedidos el código RE refiriéndose a carrete, el pedido de compra X12 EDI resultante utilizará el código ANSI correcto para carrete. Puede suceder que el proveedor identifique que el artículo se vende en rollos y rechace el pedido de compra. O puede aceptar el pedido de compra y generar una factura X12 EDI con el código ANSI incorrecto RO, que hace referencia a rollo. Ariba Network traduce RO como D65, lo cual provocará una discordancia entre la factura y el pedido de compra.La siguiente tabla muestra la asignación entre RL y RO:

Código UNUOM Código ANSI Significado

RL RE carrete (reel)

RO RL rollo

D65 RO cilindro

Guía de soluciones cXMLConvenciones de datos cXML

PUBLICPÚBLICO 27

Page 28: 355a de soluciones cXML - help.sap.com

Ejemplos correctos:

<UnitOfMeasure>EA</UnitOfMeasure> <UnitOfMeasure>M4</UnitOfMeasure> <UnitOfMeasure>HUR</UnitOfMeasure>

Ejemplos incorrectos:

<UnitOfMeasure>$</UnitOfMeasure> <UnitOfMeasure>DO</UnitOfMeasure><UnitOfMeasure>DOL</UnitOfMeasure> <UnitOfMeasure>HOUR</UnitOfMeasure>

Formatos de nombreLas implementaciones del sistema de compras deben analizar los strings de nombre y determinar cómo se han formateado. El código que lleva a cabo este análisis debe saber si un nombre corresponde a una persona, a una empresa o a otra cosa.

<Name xml:lang="en-US">Workchairs, Inc.</Name> <Name xml:lang="en-US">Smith, Bob</Name>

Los formatos de los nombres de persona deben ajustarse a la configuración nacional especificada en el elemento Name por el atributo xml:lang. En el caso de nombres ingleses utilice “apellido, nombre de pila [segundo nombre]”.

Los prefijos, p. ej. Dr., deben aparecer detrás del nombre de pila. Los sufijos deben aparecer detrás del apellido: “apellido [sufijo], nombre de pila [prefijo].” Así pues, Dr. Bob Smith III sería:

<Name xml:lang="en-US">Smith III, Bob Dr.</Name>

Elemento PostalAddressLa especificación cXML define libremente los requisitos de datos para los componentes Name, DeliverTo, y Street de un elemento PostalAddress. Hace una distinción relativamente clara entre la información DeliverTo y Street. Describa los datos de entrega como un extremo conocido para entregar servicios, por ejemplo el Servicio Postal.

Una dirección puede estar dirigida a una persona en concreto, identificando esa persona en el elemento Name o en el primer elemento DeliverTo del elemento PostalAddress. En lenguaje común, una dirección puede aparecer como:

John Smithc/o Acme, Inc.1565 Charleston Rd., M/S B.1Mountain View, CA 94043

o

28PUBLICPÚBLICO

Guía de soluciones cXMLConvenciones de datos cXML

Page 29: 355a de soluciones cXML - help.sap.com

Acme, Inc.Attn: John Smith1565 Charleston Rd., M/S B.1Mountain View, CA 94043

cXML soporta ambas formas. Introduce la primera línea en un elemento Name, la segunda en un elemento DeliverTo y la tercera en un elemento Street. Los documentos cXML resultantes contienen direcciones con nombres de personas en el elemento Name o en el elemento DeliverTo.

Muchas organizaciones no incluyen el nombre de la empresa. Sin embargo, deberían utilizar de forma consistente un formato e incluir el nombre de la compañía en todas las direcciones. Si se incluye un punto de recogida, este debería aparecer en el segundo elemento DeliverTo.

Ejemplo

<Name xml:lang="en">Acme, Inc</Name> <PostalAddress name="Headquarters"> <DeliverTo>John Smith</DeliverTo> <DeliverTo>M/S B.1</DeliverTo> <Street>1565 Charleston Rd.</Street> <City>Mountain View</City> <State>CA</State> <PostalCode>94043</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress>

Múltiples líneas en el elemento StreetLos elementos Street se dividen en elementos Street adicionales en el lugar en el que puede aparecer una coma. Ariba Network soporta cuatro elementos Street por cada dirección.

Así por ejemplo, 1565 Charleston Rd., Suite 45 debería aparecer como dos elementos Street:

<Street>1565 Charleston Rd.</Street> <Street>Suite 45</Street>

Para obtener más información sobre las transformaciones realizadas en el elemento Street por Ariba Network consulte Tranformaciones cXML en Ariba Network [página 417].

Elementos Country, State y PostalCodeUn elemento PostalAddress requiere que proporcione un elemento Country con un atributo isoCountrCode. Sin el elemento Country, un elemento PostalAddress está incompleto.

El valor Country es un nombre de país/región legible.

Para el valor de atributo isoCountryCode utilice los códigos ISO 3166-1 de dos letras. Encontrará más información en Códigos de país [página 424].

Guía de soluciones cXMLConvenciones de datos cXML

PUBLICPÚBLICO 29

Page 30: 355a de soluciones cXML - help.sap.com

Si isoCountryCode="US", el elemento State es obligatorio y debe ser una abreviatura de dos letras de un estado válida según el Servicio Postal de Estados Unidos, por ejemplo TX para Texas. También es obligatorio el PostalCode y este debe ser un código postal de cinco o nueve dígitos válido según el Servicio Postal de Estados Unidos. Si utiliza códigos postales de nueve dígitos no incluya un guión separador.

Si isoCountyCode="CA", el elemento State es obligatorio y este debe ser una abreviatura de dos letras de una provincia válida según el Servicio Postal de Canadá, por ejemplo QC para Quebec. PostalCode es obligatorio y debe ser un código postal de seis caracteres válido según el Servicio Postal de Canadá. El formato debe ser A9A9A9 sin espacios ni caracteres separadores.

El elemento PostalCode no deberá contener nunca guiones (-). Formatear el código postal para su visualización depende de la aplicación de recepción. Así por ejemplo un pedido de compra estadounidense puede contener:

<PostalCode>940431234</PostalCode>

Las aplicaciones deberían mostrarlo a los usuarios como:

94043-1234

Ejemplo correcto:

<State>FL</State> <PostalCode>342300001</PostalCode> <Country isoCountryCode="US">United States</Country>

Ejemplo incorrecto:

<State>FLA</State> <PostalCode>34230-0001</PostalCode> <Country isoCountryCode="USA">United States</Country>

“FLA” no es un código de estado válido según el Servicio Postal de Estados Unidos. Los códigos postales no deben contener guiones. “USA” no es un código de país ISO 3166-1 válido.

NotaNo confunda el elemento Country con el elemento CountryCode. Utilice Country para direcciones postales y CountryCode para números de teléfono.

Elemento TelephoneNumber

Los números de teléfono completos están formados por tres elementos: código de país, código de área o ciudad y número.

Los elementos cXML TelephoneNumber tienen el formato siguiente:

<TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode>650</AreaOrCityCode> <Number>9306200</Number> </TelephoneNumber>

30PUBLICPÚBLICO

Guía de soluciones cXMLConvenciones de datos cXML

Page 31: 355a de soluciones cXML - help.sap.com

Ejemplo de un número de teléfono de Londres:

<TelephoneNumber> <CountryCode isoCountryCode="UK">44</CountryCode> <AreaOrCityCode>20</AreaOrCityCode> <Number>78628500</Number> </TelephoneNumber>

Elemento CountryCode

El elemento CountryCode contiene un código de país ISO 3166-1 de dos letras y un código de marcación de la UIT.

Encontrará los códigos de país ISO 3166-1 en Códigos de país [página 424]. Encontrará los códigos de marcación de la UIT en Códigos de marcación [página 427].

NotaEl código de marcación de la UIT no es un código de país numérico ISO 3166-1 (Estados Unidos tiene el valor “840” en este sistema.)

Ejemplos correctos:

<CountryCode isoCountryCode="US">1</CountryCode> <CountryCode isoCountryCode="CA">1</CountryCode><CountryCode isoCountryCode="FR">33</CountryCode> <CountryCode isoCountryCode="MC">377</CountryCode>

NotaUn único código de país ISO puede servir para varios países.

Ejemplos incorrectos:

<CountryCode isoCountryCode="US">US</CountryCode>

No contiene el código de marcación de la UIT.

<CountryCode isoCountryCode="US">011</CountryCode>

Contiene “011”, que es el código de escape para la marcación internacional desde los Estados Unidos, en lugar del código de marcación de la UIT.

NotaNo debe confundirse el elemento Country con el elemento CountryCode. Utilice Country para direcciones postales y CountryCode para números de teléfono.

Guía de soluciones cXMLConvenciones de datos cXML

PUBLICPÚBLICO 31

Page 32: 355a de soluciones cXML - help.sap.com

Elementos AreaOrCityCode y Number

Los códigos de área y de ciudad tienen longitudes diferentes en función de la localidad. A veces, en el elemento Number también aparecen códigos de marcación de “escape” y códigos de país.

No agregue “1” al elemento AreaOrCityCode.

No utilice signos de puntuación como “(800) 555-5555” en el elemento Number.

Ejemplo correcto:

<AreaOrCityCode>800</AreaOrCityCode> <Number>5555555</Number>

Ejemplos incorrectos:

<AreaOrCityCode>1800</AreaOrCityCode> <Number>5555555</Number>

Contiene un “1” antes del código de área.

<AreaOrCityCode>800</AreaOrCityCode> <Number>555-5555</Number>

El número de teléfono no debe contener signos de puntuación.

Formato de fecha y hora

Utilice el formato ISO 8601 para los valores de fecha y hora. El formato es YYYY-MM-DDThh:mm:ss-hh:mm.

Por ejemplo:

<OrderRequestHeader orderID="3333" orderDate="2001-12-20T09:25:57+01:00" type="new">

El componente “+01:00” significa una hora más del tiempo universal coordinado (UTC). No convierta el componente de hora al tiempo universal coordinado; déjelo como hora local.

Ejemplos incorrectos:

19990817T233535Z 2000-3-18T11:33:32

En ambos ejemplos falta la información de zona horaria necesaria.

Atributo de marca de tiempo

Ariba Network trata el atributo cXML@timestamp de forma diferente para los diferentes tipos de documentos.

32PUBLICPÚBLICO

Guía de soluciones cXMLConvenciones de datos cXML

Page 33: 355a de soluciones cXML - help.sap.com

● Documentos comunicados por los compradores (por ejemplo, los pedidos): Ariba Network no valida el valor timestamp para los documentos comunicados por los compradores. timestamp puede ser cualquier cadena, incluyendo una de nula.

● Documentos comunicados por los proveedores (por ejemplo, las facturas): Ariba Network requiere un valor timestamp válido en el formato ISO 8601 para todos los documentos comunicados por los proveedores. De manera predeterminada, Ariba Network utiliza la fecha y el huso horario del sistema del host (hora estándar del Pacífico) para el valor timestamp. Si la fecha seleccionada no es la actual, la marca de tiempo se enviará a mediodía de ese día.

Tratamiento de los caracteres especiales en los documentos

En cXML y XML no es posible escribir todos los caracteres desde el teclado. Otros caracteres, como < y &, tienen un significado especial para XML. Estos caracteres deben estar codificados mediante entidades de caracteres.

XML define las siguientes entidades de caracteres integradas:

Entidad Carácter

&lt; <

&gt; >

&amp; &

&quot; “

&apos; ‘

Para los caracteres que no pertenecen a la codificación utilizada, utilice el número de Unicode del carácter (decimal o hexadecimal), precedido por el signo de la libra (#). Por ejemplo, &#174; y &#xAE; representan el símbolo de la marca registrada, ®.

Por ejemplo,

<Description xml:lang="en-US">The best prices for software®</Description>

se ha podido codificar como

<Description xml:lang="en-US">The best prices for software &#174;</Description>

Las comillas simples (') o dobles (") solo se deben evitar dentro de los valores de atributo que se citan entre comillas mediante este delimitador. Se recomienda utilizar solo comillas simples para delimitar los atributos, a menos que el contenido nunca contenga comillas.

Para tratar los caracteres especiales en los documentos:

1. Utilice una plantilla que solo utilice comillas simples para delimitar los atributos.2. Agregue valores a la plantilla mediante una de las siguientes acciones:

○ Si el documento es un PunchOutOrderMessage que debe ser transferido por el campo oculto cxml-urlencoded, rellene los valores en la plantilla utilizando la codificación US-ASCII. Esta codificación requiere

Guía de soluciones cXMLConvenciones de datos cXML

PUBLICPÚBLICO 33

Page 34: 355a de soluciones cXML - help.sap.com

entidades de caracteres XML para todos los caracteres que no pertenecen a la codificación. Por ejemplo, introduzca el símbolo de la marca registrada (®), que no está disponible en US-ASCII, como &#174;.

○ De lo contrario, rellene los valores del documento con la codificación UTF-8. UTF-8 debe utilizarse para todos los documentos enviados directamente por HTTP Post o integrados en un campo oculto cXML-base64. UTF-8 incluye todos los US-ASCII.

3. XML evita los valores de atributo y el contenido de elemento a medida que crea el documento cXML. Los caracteres que deben evitarse son &, ', < y >.Los pasos siguientes son necesarios si está transfiriendo el documento en un PunchOutOrderMessage.

4. Preste atención a todos los caracteres que interpretan los navegadores:○ Si está utilizando un campo oculto cxml-urlencoded, convierta todas las comillas dobles en &#34;.○ Además, (para el campo cxml-urlencoded), evite todos los signos & que se muestran en contextos

significativos para HTML con &amp;. Para asegurarse, puede evitar todos los signos &. Por ejemplo, evite el signo & como &amp; y el apóstrofe (') como &apos;. Evite el símbolo de la marca registrada (®) como &#174;.

○ En caso contrario, si está utilizando un campo oculto cxml-base64, base64 codificará todo el documento cXML.

5. Integre el documento en el formulario HTML con comillas dobles alrededor del valor de cadena.

Para obtener más información acerca de los caracteres especiales en cXML, consulte Guía de referencia de cXML disponible en http://www.cxml.org .

Elementos extrínsecosLos elementos extrínsecos definen información adicional innecesaria para la mayoría de las interacciones comerciales estándar pero que puede ser útil para algunas organizaciones para sus transacciones. De forma predeterminada, SAP Ariba admite algunos extrínsecos.

Ariba Buyer 6.1 y 7.0 incluyen un conjunto distinto de extrínsecos. De forma predeterminada, Ariba Buyer 6.1 incluye los extrínsecos "User" y "CostCenter". De forma predeterminada, Ariba Buyer 7.0 incluye los extrínsecos "UniqueName" y "UserEmail". Cualquier otro extrínseco adicional debería ser acordado entre la organización compradora y el proveedor.

NotaEn el caso de instalaciones Ariba Buyer anteriores se recomienda que las organizaciones compradoras cambien "User" por "UniqueName" e informen de ello a sus proveedores.

Para obtener una lista de transformaciones realizadas en los extrínsecos por Ariba Network, consulte Tranformaciones cXML en Ariba Network [página 417].

34PUBLICPÚBLICO

Guía de soluciones cXMLConvenciones de datos cXML

Page 35: 355a de soluciones cXML - help.sap.com

Direccionamiento y seguridad de documentos

Los documentos cXML viajan entre aplicaciones geográficamente separadas a través de intranets corporativas e Internet. Para garantizar la confidencialidad de los datos de negocio y protegerlos de accesos no autorizados, las aplicaciones compatibles con cXML soportan una comunicación segura.

Resumen de la seguridad del documento [página 35]

Conexiones HTTPS [página 36]

Autentificación de documentos cXML [página 38]

Certificados digitales [página 41]

Acerca de credenciales cXML [página 44]

Credenciales obligatorias [página 49]

Integración de extremos con adaptadores Ariba Network [página 57]

Activación rápida [página 60]

Resumen de la seguridad del documentoUna comunicación segura es posible gracias a dos mecanismos: el cifrado y la autentificación de documentos.

Cifrado de documentos

Las aplicaciones cifran documentos cXML antes de transmitirlos enviándolos a través de conexiones HTTPS.

HTTPS es una forma segura de HTTP (HyperText Transfer Protocol) soportada por la mayoría de los servidores y navegadores web. Protege la comunicación en la red codificando datos para que partes no autorizadas no puedan interpretarlos.

Encontrará más información sobre HTTP en Conexiones HTTPS [página 36].

Autentificación de documentos cXML

Las aplicaciones autentifican los documentos cXML recibidos para comprobar su validez. La autentificación garantiza que todos los documentos proceden de una organización reconocida.

Dado que las aplicaciones que admiten documentos cXML se comunican a través de Internet, deben llevar a cabo la autentificación en todos los documentos cXML recibidos con el fin de evitar accesos no autorizados.

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

PUBLICPÚBLICO 35

Page 36: 355a de soluciones cXML - help.sap.com

Encontrará más información sobre la autentificación de documentos en Autentificación de documentos cXML [página 38].

Conexiones HTTPSAriba Network es un servicio disponible en Internet. Todos los documentos cXML que recibe o envía se transmiten por Internet. Para garantizar una transmisión segura de los documentos a través de Internet, Ariba Network exige que todas las conexiones entrantes y salientes se establezcan a través de HTTPS.

Las conexiones HTTPS permiten a los servidores web y a los clientes cifrar documentos cXML para una transmisión segura por Internet.

Ariba Network no inicia ni acepta solicitudes de conexión HTTP simples. Por ello, las organizaciones compradoras, los proveedores habilitados para cXML y los proveedores de servicios deben soportar HTTPS.

HTTPS se basa en el cifrado proporcionado por un protocolo criptográfico denominado Transport Layer Security (TLS). TLS agrega mejoras criptológicas al TCP/IP (Transmission Control Protocol/Internet Protocol), el protocolo de comunicaciones de Internet.

● Para recibir documentos cXML de Ariba Network, los servidores web externos (incluido el sitio de PunchIn de Ariba Buyer 8.1 o posteriores) deben aceptar solicitudes de conexiones HTTPS y crear conexiones HTTPS. Debe instalar en su servidor web un certificado de servidor web TLS procedente de una autoridad de certificados de confianza. Encontrará más información sobre estos certificados en Resumen de certificados digitales [página 41].

● Para enviar documentos cXML a Ariba Network, todas las aplicaciones habilitadas para cXML deben poder iniciar solicitudes de conexión HTTPS.

Todas las URLs introducidas en cuentas Ariba Network deben tener valores que comiencen por https://.

Los miembros de Ariba Network deben realizar tareas específicas para admitir las comunicaciones HTTPS.

HTTPS para organizaciones compradoras [página 36]

Cómo verificar URL en cuentas de Ariba Network (sitios de PunchIn de facturación colaborativa) [página 37]

HTTPS para proveedores y proveedores de servicios [página 37]

Cómo activar HTTPS en servidores Web [página 37]

Cómo verificar URLs en la cuenta de Ariba Network [página 38]

HTTPS para organizaciones compradorasDebe configurar Ariba Buyer y SAP Ariba Sourcing para enviar documentos a URL de Ariba Network precedidos de HTTPS.

Ariba Buyer y SAP Ariba Sourcing pueden iniciar con éxito conexiones HTTPS con Ariba Network porque vienen con un certificado CA preinstalado que les permite reconocer el emisor del certificado TLS de Ariba Network.

Si utiliza el sitio PunchIn de facturación colaborativa, este debe estar habilitado para aceptar la comunicación HTTPS desde Ariba Network. Es decir, debe asegurarse de que todos las URL introducidas en su cuenta Ariba Network especifican HTTPS en direcciones web.

36PUBLICPÚBLICO

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

Page 37: 355a de soluciones cXML - help.sap.com

Información relacionada

Guía de seguridad de SAP Ariba

Cómo verificar URL en cuentas de Ariba Network (sitios de PunchIn de facturación colaborativa)

Si utiliza un sitio de PunchIn de facturación colaborativa, compruebe que sus URL utilizan HTTPS.

Procedimiento

1. Inicie sesión en su cuenta de Ariba Network.2. En el área de configuración de la cuenta, compruebe que la URL cXML ProfileRequest utiliza "https://".

Resultados

Ariba Network almacena en caché su perfil cXML. Puede borrarlo haciendo clic en el botón Restablecer perfil de su cuenta. Para obtener más información, consulte Uso de la transacción del perfil [página 73].

HTTPS para proveedores y proveedores de servicios

Activa HTTPS en servidores Web conectados a sus aplicaciones cXML y garantiza que todas las URL introducidas en su cuenta Ariba Network especifiquen direcciones https://.

Cómo activar HTTPS en servidores Web

Los servidores web que utilicen sus aplicaciones cXML deben admitir HTTPS.

Procedimiento

1. Asegúrese de que su servidor Web sea compatible con Transport Layer Security (TLSv1.2 o TLSv1.3).2. Compruebe que su servidor web esté configurado para DNS (Domain Name Service).3. Compre e instale un certificado de servidor web SSL. Para obtener más información, consulte Obtención de un

certificado digital [página 43].

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

PUBLICPÚBLICO 37

Page 38: 355a de soluciones cXML - help.sap.com

Siga las instrucciones de su servidor web para instalar el certificado.4. Compruebe que envía cabeceras HTTPS adecuadas en las respuestas.5. (Opcional) Configure su servidor web para no admitir solicitudes cXML HTTP no seguras.

Cómo verificar URLs en la cuenta de Ariba Network

Establezca las URL ProfileRequestURL, PunchOutSetupRequest y OrderRequest para admitir HTTPS.

Procedimiento

1. Inicie sesión en su cuenta de Ariba Network.2. En el área de configuración de la cuenta, compruebe que todas las URL cXML utilizan "https://". Puede

configurar las siguientes URL cXML en su cuenta:

○ URL ProfileRequest○ URL PunchOutSetupRequest○ URL OrderRequest

3. Si admite la transacción de perfil cXML, compruebe que ProfileResponse devuelve URL https.

Ariba Network almacena en caché su perfil XML; puede eliminar esta memoria caché si hace clic en el botón Restablecer perfil en su cuenta. Para obtener más información, consulte Uso de la transacción de perfil [página 73].

4. Si admite las transacciones PunchOut cXML o ProviderSetup, se recomienda que devuelva URL https en sus documentos PunchOutSetupResponse o ProviderSetupResponse.

Autentificación de documentos cXML

Ariba Buyer, SAP Ariba Sourcing, Ariba Network y los sitios que admiten cXML (como los sitios PunchOut) son aplicaciones que envían y reciben documentos cXML. Estas aplicaciones autentifican todos los documentos cXML que reciben para garantizar que proceden de organizaciones válidas.

Métodos de autentificación disponibles [página 39]

Instalación de la autentificación de certificados [página 39]

Cómo instalar el certificado en Ariba Network [página 39]

Cambio de sus URL Ariba Network [página 40]

Autenticación del certificado de Ariba Network [página 41]

38PUBLICPÚBLICO

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

Page 39: 355a de soluciones cXML - help.sap.com

Métodos de autentificación disponiblesAl configurar su cuenta de Ariba Network, puede elegir entre dos métodos de autenticación cXML disponibles: la clave compartida o el certificado digital.

● Clave compartida: (Opción predeterminada) Introduzca una cadena de texto confidencial en su cuenta de Ariba Network y configure su aplicación cXML con la misma cadena (si las claves compartidas no coinciden, los documentos no podrán entregarse). A continuación, estas aplicaciones insertan la cadena con la clave compartida en los documentos cXML que generan. Cada aplicación autentifica los documentos cXML recibidos comparando la clave compartida que aparece en esos documentos con la clave que conocen.La autentificación mediante clave compartida es fácil de configurar y requiere poco mantenimiento. Para aprender a especificar su clave compartida, consulte Configuración del enrutamiento de documento (para los proveedores) o Guía de administración del comprador de Ariba Network (para las organizaciones compradoras).

NotaSAP Ariba Cloud Integration Gateway no admite la clave compartida en la carga útil de cXML. Si los proveedores envían la clave compartida, SAP Ariba Cloud Integration Gateway eliminará esta información antes de enviar el documento a Ariba Network.

● Certificado digital: Compre y actualice un certificado digital de cliente de una autoridad de certificados de confianza. A continuación introduzca ese certificado en su cuenta de Ariba Network. Ariba Network y su aplicación hacen referencia a ese certificado digital para la autentificación. El certificado no aparece en el documento cXML ni adjunto al documento. En lugar de ello, el protocolo TLS lo intercambia antes de que tenga lugar el intercambio de documentos.La autentificación mediante certificado digital requiere más configuración. Además, los certificados cuestan dinero y vencen pasado un tiempo. Sin embargo, es posible que este método sea más compatible con la estrategia de seguridad de su organización.

NotaLas organizaciones compradoras que utilizan la autentificación mediante certificado digital no pueden utilizar el sitio PunchIn de Ariba Buyer Collaboration. El sitio PunchIn sólo soporta la autentificación mediante clave compartida.

Instalación de la autentificación de certificadosLas organizaciones pueden instalar certificados digitales como alternativa a claves compartidas para la autentificación de documentos cXML. Para configurar la autenticación de certificados digitales, obtenga un certificado de cliente firmado, instálelo en su cuenta de Ariba Network y cambie las URL a aquellas en las que publica documentos.

Cómo instalar el certificado en Ariba NetworkPara configurar la autentificación de certificado en Ariba Network debe instalar un certificado firmado digitalmente.

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

PUBLICPÚBLICO 39

Page 40: 355a de soluciones cXML - help.sap.com

Procedimiento

1. Obtenga un certificado firmado digitalmente de una autoridad de certificación de confianza para SAP Ariba.2. Inicie sesión en su cuenta Ariba Network. Debe tener privilegios de administrador de cuenta.

3. Seleccione Administración Configuración .4. En la página Configuración, haga clic en Configuración cXML.5. Establezca Método de autentificación en "Certificado".6. En su ordenador, abra el archivo del depósito de claves del certificado digital de la autoridad de certificados en

un editor de textos, como Microsoft Notepad.7. Copie el texto, empezando por "-----BEGIN CERTIFICATE-----" y terminando por

"-----END CERTIFICATE-----".

8. Pegue el texto en el cuadro de texto Certificado en Ariba Network.

NotaTambién puede utilizar un certificado digital de respaldo. Ariba Network utiliza el certificado de respaldo si su certificado principal se convierte en inválido. Los certificados de respaldo son útiles cuando su certificado principal vence o cuando necesita realizar un mantenimiento de certificados.

9. Haga clic en Guardar.

Pasos siguientes

Los certificados digitales vencen después de un período de tiempo predeterminado. Está bajo su responsabilidad el hecho de obtener periódicamente certificados actualizados de su autoridad de certificados e instalarlos en Ariba Network.

Cambio de sus URL Ariba Network

Configure su aplicación compatible con cXML para utilizar la transacción de perfil cXML con el fin de obtener las URL de Ariba Network para la publicación de documentos.

Ariba Network tiene un conjunto diferente de URL para documentos cXML autentificados mediante clave compartida y mediante certificado. Por ejemplo:

Centro de datos

Método de autentifica­ción URL de Ariba Network existente URL de Ariba Network solo de integración

EE. UU. clave compar­tida

https://service.ariba.com/service/transaction/cxml.asp

https://service-2.ariba.com/service/transac­tion/cxml.asp

Certificado https://certservice.ariba.com/service/transac­tion/cxml.asp

https://certservice-2.ariba.com/service/tran­saction/cxml.asp

40PUBLICPÚBLICO

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

Page 41: 355a de soluciones cXML - help.sap.com

NotaSAP Ariba recomienda utilizar TLS 1.2 o TLS 1.3 y las URL de Ariba Network solo de integración para el tráfico de cXML. La dirección URL de Ariba Network existente se utiliza como la dirección URL del navegador para aplicaciones de SAP Ariba.

La URL de certificado funciona tanto en la autentificación mediante certificado como en la autentificación basada en clave compartida.

La transacción de perfil es la mejor forma de buscar las últimas URL para publicar documentos cXML.

NotaLos proveedores no pueden utilizar autofirmados, pero pueden utilizar HTTPS para conectar con SAP Ariba Cloud Integration Gateway para cXML.

Autenticación del certificado de Ariba Network

Si su aplicación cXML autentifica Ariba Network verificando el certificado de cliente de Ariba Network, verifique los campos de certificado que no varían, como por ejemplo el nombre distintivo del asunto y del emisor (Subject Distinguished Name e Issuer Distinguished Name). No verifique certificados a partir de campos que varían regularmente, como por ejemplo el período de validez o el número de serie.

Certificados digitalesLos certificados digitales son esenciales para garantizar la comunicación cXML. Se utilizan tanto para activar conexiones HTTPS como para autentificar documentos cXML.

Resumen de certificados digitales [página 41]

Certificados de cliente y de servidor [página 42]

Autoridades de certificados de confianza [página 42]

Intensidad de cifrado [página 42]

Nombre de dominio en certificados de servidor [página 43]

Cómo obtener un certificado digital [página 43]

Resumen de certificados digitales

Los certificados digitales utilizan criptografía de clave pública, que es una forma de criptografía que utiliza dos claves a las que se denomina pareja de claves. La pareja de claves está formada por una clave privada que únicamente conoce el propietario de la pareja y una clave pública a la que cualquier persona tiene acceso.

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

PUBLICPÚBLICO 41

Page 42: 355a de soluciones cXML - help.sap.com

Los componentes de la pareja de claves están relacionados matemáticamente, de modo que el texto cifrado creado utilizando uno de los componentes de la pareja puede descifrarse con el otro componente.

Obtendrá un certificado firmado si envía una solicitud firmada con su clave privada y que contenga su clave pública a una autoridad de certificados de confianza, la cual le devolverá un certificado que contendrá su clave pública e irá firmado con su clave privada.

NotaLos certificados digitales vencen después de un período de tiempo predeterminado. Tras su vencimiento, las solicitudes de conexión HTTPS con sus servidores web se rechazan y falla la autentificación del documento cXML basada en el certificado. Usted es el responsable de renovar sus certificados a su debido tiempo.

Certificados de cliente y de servidor

Los certificados de servidor se utilizan para TLS, lo cual se necesita para aceptar solicitudes de conexión HTTPS. Estos certificados también se denominan certificados de servidor web, certificados de servidor seguro e ID de servidor seguro. Los certificados de cliente se utilizan para la "autentificación de documento cXML basada en certificado.”

Encontrará más información sobre HTTP en Conexiones HTTPS [página 36]. Encontrará más información sobre cXML en Autentificación de documento cXML [página 38].

Un certificado en concreto se puede utilizar como certificado tanto de servidor como de cliente en función de la información que la autoridad de certificados incluya:

● Si las secciones de utilización clave ampliadas X.509v3 o Netscape están presentes, el certificado no se puede utilizar para ningún fin no especificado por el certificado (p. ej., servidor o cliente).

● Si las secciones de utilización clave ampliadas If X.509v3 o Netscape no están presentes, el certificado se puede utilizar para cualquier fin (incluido de servidor y cliente).

Si prevé utilizar un certificado concreto tanto para la autentificación TLS como para la basada en certificado, solicite a su autoridad de certificados que le proporcione un certificado que sea tanto de servidor como de cliente.

Autoridades de certificados de confianza

Puede utilizar un certificado digital firmado emitido por cualquier organización emisora. Debe hacer referencia a un certificado raíz de una autoridad de certificación (CA) considerada de confianza por SAP Ariba. Para obtener información sobre las autoridades de certificación que SAP Ariba considera actualmente de confianza o para registrar una autoridad de certificación para que SAP Ariba la considere de confianza, póngase en contacto con el servicio de asistencia de SAP Ariba.

Intensidad de cifrado

SAP Ariba recomienda utilizar un cifrado de 128 bits o superior.

42PUBLICPÚBLICO

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

Page 43: 355a de soluciones cXML - help.sap.com

Las intensidades habituales de cifrado son 40, 56 y 128 bits; cuando mayor sea el número de bits del cifrado más fuerte será el cifrado y más segura será la conexión TLS.

Tenga en cuenta que los "certificados de 128 bits" no son necesarios para soportar el cifrado de 128 bits. La mayoría de los "certificados de 40 bits" soportan un cifrado de 128 bits o superior. Los "certificados de 128 bits" habilitan la criptografía activada por servidor, que Ariba Network no utiliza. En la mayoría de los casos puede utilizar "certificados de 40 bits" más económicos; consulte con su autoridad de certificados las intensidades de cifrado soportadas.

Nombre de dominio en certificados de servidor

El campo CN (Common Name) en el certificado del servidor para HTTPS debe ser un nombre de dominio DNS completamente cualificado de un servidor web. Por ejemplo, un nombre de dominio DNS completamente cualificado adopta el formato "https//www.example.com".

Debe introducir en los campos URL transactivos del área Configuración de su cuenta Ariba Network el mismo nombre que aparece en su ProfileResponse cXML No utilice direcciones IP porque no puede introducir direcciones IP en su cuenta Ariba Network.

Utilice un certificado diferente para cada nombre DNS al que los clientes intentarán conectarse. Los nombres de certificado no especifican puertos de servidor, de modo que varias instancias de servidor web en distintos puertos pueden utilizar el mismo certificado. Sin embargo, varios servidores web no pueden compartir un único certificado.

Cómo obtener un certificado digital

Obtenga un certificado firmado digitalmente de una autoridad de certificación de confianza para SAP Ariba.

Procedimiento

1. Utilice su servidor web o una herramienta de terceros, como por ejemplo keytool o ikeyman, para generar un Certificate Signing Request (CSR). Es un archivo para describir su organización para una autoridad de certificados.

2. Envíe el CSR a una autoridad de certificados de confianza de Ariba Network y solicite un certificado digital firmado X.509 V3 de clase 3 codificado en Base64.

Solicite un certificado de servidor para TLS o un certificado de cliente para la autentificación basada en certificados. Debe obtener un certificado que funcione para ambos objetivos; para obtener más información, consulte Acerca de certificados de cliente y de servidor [página 42]

3. La autoridad de certificados devuelve un certificado firmado.

Los archivos de certificado digital pueden ser en formato binario Distinguished Encoding Rules (DER) o en formato Privacy-Enhanced Mail (PEM) codificado en base64.

Los contenidos del archivo deben empezar por:

---- BEGIN CERTIFICATE ----

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

PUBLICPÚBLICO 43

Page 44: 355a de soluciones cXML - help.sap.com

Asimismo, el archivo debe terminar por:

---- END CERTIFICATE ----

Pasos siguientes

● Para utilizar el certificado para habilitar HTTPS, consulte Conexiones HTTPS [página 36].● Para utilizar el certificado para la autentificación de documentos cXML, consulte Autentificación de

documentos cXML [página 38].

Acerca de credenciales cXMLLos elementos Credential cXML en la cabecera de cada documento cXML identifican las organizaciones remitentes y destinatarias.

Dominios de ID soportados [página 44]

Credenciales múltiples [página 45]

Diferenciación entre mayúsculas y minúsculas [página 47]

Cambios de dominio [página 47]

ID de Ariba Network y versiones anteriores de Ariba Buyer [página 47]

Elemento DigitalSignature [página 48]

Cuentas de prueba [página 49]

Dominios de ID soportados

Las aplicaciones SAP Ariba utilizan una serie de dominios para ID de credenciales cXML.

● NetworkID—Un valor alfanumérico único asignado a cada organización registrada en Ariba Network, por ejemplo AN01000000123. Las organizaciones pueden ver sus propios ID de Ariba Network y los de sus socios comerciales accediendo a Ariba Network.

● DUNS—Un número único que Dun & Bradstreet asigna a organizaciones, por ejemplo 942888711. Para solicitar un número Dun & Bradstreet D-U-N-S® o ver si su organización ya cuenta con uno, vaya a http://www.dnb.com

.● AribaNetworkUserId— Un nombre de inicio de sesión de un usuario Ariba Network. Estos nombres tienen

por lo general el mismo formato que una dirección de correo electrónico, por ejemplo [email protected]. Este no es el dominio preferido porque si los usuarios cambian sus nombres de inicio de sesión es posible que el enrutamiento de los documentos cXML falle.

● PrivateId— (solo para activación rápida o conectividad de proveedor) Un valor alfanumérico único definido por una organización compradora para un proveedor en particular, por ejemplo Supplier123. Cuando Ariba Network recibe documentos de organizaciones compradoras, asigna esos ID a NetworkID. Cuando Ariba

44PUBLICPÚBLICO

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

Page 45: 355a de soluciones cXML - help.sap.com

Network envía documentos a organizaciones compradoras, asigna NetworkID, DUNS y AribaNetworkID de los proveedores a PrivateId. Los proveedores no pueden utilizar este dominio.

● ProviderId—(solo para activación rápida) Un valor alfanumérico único definido por un proveedor de servicios para un proveedor en particular, por ejemplo Supplier123. Cuando Ariba Network recibe facturas de proveedores de servicios, intenta asignar esos ID a NetworkID o PrivateId. Si no puede hacerlo, envía las facturas a la página Facturas no asignadas de la organización compradora. Las organizaciones compradoras y los proveedores no pueden utilizar este dominio.

● VendorID—Nombre unívoco del proveedor que es el ID de proveedor en el sistema ERP del comprador. Es un valor alfanumérico. La combinación de VendorID y VendorSiteID forma la clave compuesta de suministrador, la cual define unívocamente un proveedor. Ariba Network puede utilizar la clave compuesta de suministrador para la activación rápida. Cuando Ariba Network recibe documentos de organizaciones compradoras, asigna esos ID a NetworkID. Los proveedores no pueden utilizar este dominio. Este dominio es aplicable a los compradores que utilizan Soluciones de SAP Ariba Procurement a petición o SAP Ariba Commerce Automation.

● VendorSiteID—ID de sitio de ubicación de proveedor e ID de contacto de ubicación de proveedor. Incluye dos dominios IdReference, SiteID y SiteAuxID. Estos valores proceden del sistema ERP del comprador. Este valor alfanumérico es parte de la clave compuesta de suministrador. (Encontrará más información en VendorID.) Los proveedores no pueden utilizar este dominio. Este dominio es aplicable a los compradores que utilizan Soluciones de SAP Ariba Procurement a petición o SAP Ariba Commerce Automation.

● SystemID—(solo para conectividad de proveedor) Un valor alfanumérico único definido por una organización compradora para una aplicación empresarial en particular, por ejemplo SAP1. Cuando Ariba Network recibe documentos que contienen este dominio de ID, los asocia a la aplicación empresarial y las direcciones Facturar a configuradas en la cuenta del comprador.

● SSPPrivateID—(Sólo on demand Soluciones de SAP Ariba Procurement). Un ID privado de ubicación de proveedor generado automáticamente (llamado Ariba Network ID privado en Soluciones de SAP Ariba Procurement). Este ID se genera en Soluciones de SAP Ariba Procurement para cada ubicación de proveedor. Identifica unívocamente una ubicación de proveedor. Antes de liberar 12s2, este valor se ha enviado utilizando el dominio PrivateID. Para garantizar el correcto enrutamiento de documentos heredados que utilizan PrivateID para especificar este valor autogenerado, Ariba Network utiliza tanto SSPPrivateID como PrivateID para encontrar proveedores coincidentes en documentos enviados desde la solución SAP Ariba. Los documentos salientes no incluyen el dominio SSPPrivateID. Utilizan el dominio PrivateID para incluir el valor de ID privado de la ubicación del proveedor. Los proveedores no pueden utilizar este dominio.

● ChildSystemId: Identifica territorios secundarios en una configuración de varios sistemas ERP.

Para obtener más información sobre PrivateId, ProviderId, VendorID y VendorSiteID, consulte Activación rápida [página 60].

Credenciales múltiples

Opcionalmente, cada uno de los elementos From, To y Sender pueden contener múltiples elementos Credential. El objetivo de proporcionar múltiples credenciales es identificar una única organización mediante diferentes dominios. Una organización puede ser identificada por ejemplo incluyendo tanto un número D-U-N-S como un número de ID de Ariba Network.

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

PUBLICPÚBLICO 45

Page 46: 355a de soluciones cXML - help.sap.com

Ejemplo

<To> <Credential domain="partition-oracle107"> <Identity>1001134</Identity> </Credential> <Credential domain="DUNS"> <Identity>123456789</Identity> </Credential> <Credential domain="NetworkID"> <Identity>AN1000000123</Identity> </Credential> </To>

Ejemplo

El siguiente es un ejemplo de To credential de Soluciones de SAP Ariba Procurement, que incluye VendorID y VendorSiteID:

<To> <Credential domain=”NetworkId”> <Identity>AN01000252747</Identity> </Credential> <Credential domain=”PrivateID”> <Identity>v2034</Identity> </Credential> <Credential domain=”SSPPrivateID”> <Identity>sid498__1000195__1000027</Identity> </Credential> <Credential domain=”VendorID”> <Identity>v2034</Identity> </Credential> <Credential domain=”VendorSiteID”> <Identity> <IdReference domain=”SiteID” identifier=”MainSite”> <IdReference domain=”SiteAuxID” identifier=”contact2”> </Identity> </Credential> </To>

El sistema receptor deberá validar todas las credenciales con dominios que reconozca y rechazar el documento si algunas credenciales con dominios reconocidos no se corresponden con una organización que conozca. También debería rechazar el documento si dos de las credenciales de la misma sección From, To o Sender hacen referencia a distintas entidades.

El sistema receptor debería rechazar el documento si hay múltiples credenciales en una sección To, From o Sender que utilizan distintos valores pero el mismo dominio.

NotaSAP Ariba Cloud Integration Gateway no admite las credenciales múltiples en la cabecera del mensaje y las credenciales del emisor o del destinatario deben ser ANID.

46PUBLICPÚBLICO

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

Page 47: 355a de soluciones cXML - help.sap.com

Diferenciación entre mayúsculas y minúsculas

La diferenciación entre mayúsculas y minúsculas en los datos de credenciales depende del dominio de la credencial. Los valores NetworkID y DUNS no diferencian entre mayúsculas y minúsculas, al contrario que AribaNetworkUserId, PrivateId, ProviderId, VendorID, VendorSiteID y SSPPrivateID.

Así por ejemplo las aplicaciones no deberían distinguir entre los valores NetworkID “an1234” y “AN1234.”

Las aplicaciones no deberían diferenciar entre mayúsculas y minúsculas en el caso de los nombres de dominio propiamente dichos (NetworkID, DUNS y AribaNetworkUserId, PrivateId, ProviderId, VendorID, VendorSiteID, y SSPPrivateID). Así por ejemplo, DUNS y duns son iguales.

Cambios de dominio

Ariba Network puede cambiar dominios de credencial en documentos enrutados a proveedores. En cualquier documento cXML enrutado a proveedores, Ariba Network cambia AribaNetworkUserId por NetworkID en credenciales From.

Así por ejemplo, cuando un documento PunchOutSetupRequest se enruta de un comprador a un proveedor, Ariba Network cambia

<From> Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> </Credential>

a

<From> <Credential domain="NetworkID"> <Identity>AN01000000123</Identity> </Credential>

ID de Ariba Network y versiones anteriores de Ariba Buyer

Es posible que algunos proveedores no tengan números D-U-N-S. Si esos proveedores tienen clientes que utilizan versiones anteriores de Ariba Buyer tendrán ser capaces de interpretar los valores de ID de Ariba Network utilizados en el dominio de credencial DUNS en documentos PunchOutSetupRequest y OrderRequest.

Para organizaciones compradoras que utilicen versiones anteriores de Ariba Buyer

Los administradores que utilicen versiones anteriores de Ariba Buyer deberán cargar nuevos proveedores mediante el valor NetworkID en el dominio DUNS si este es el único valor proporcionado por los proveedores.

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

PUBLICPÚBLICO 47

Page 48: 355a de soluciones cXML - help.sap.com

Para proveedores con clientes que utilicen versiones anteriores de Ariba Buyer

Los proveedores habilitados para cXML pueden recibir una pareja dominio-valor discordante en la que el dominio es siempre DUNS pero el valor puede ser ID de Ariba Network o DUNS en función de qué organizaciones compradoras se hayan configurado para proveedores.

Los proveedores habilitados para cXML sin números D-U-N-S que tengan clientes en versiones anteriores de Ariba Buyer deben poder interpretar valores ID de Ariba Network en credenciales independientemente del dominio. (Para el nivel más alto de compatibilidad, los proveedores habilitados para cXML deberían interpretar valores de ID de Ariba Network y DUNS independientemente del dominio en To Credential.)

Por ejemplo:

<To> <Credential domain="DUNS"> <Identity>AN01000000123</Identity> </Credential> </To>

o

<To> <Credential domain="NetworkID"> <Identity>AN01000000123</Identity> </Credential> </To>

o

<To> <Credential domain="DUNS"> <Identity>123456789</Identity> </Credential> </To>

Para evitar tener que implementar este método alternativo, los proveedores habilitados para cXML deberían obtener números D-U-N-S, introducirlos en sus cuentas Ariba Network y comunicarlos a sus clientes para utilizarlos dentro de Ariba Buyer.

Elemento DigitalSignature

La especificación cXML define un elemento denominado DigitalSignature en el elemento Sender. Las aplicaciones de SAP Ariba no utilizan este elemento.

NotaNo inserte este elemento en documentos cXML.

Para autentificar documentos utilice claves compartidas o certificados digitales. Encontrará información sobre la autentificación de documentos transferidos entre aplicaciones y Ariba Network en Autentificación de documentos cXML [página 38].

48PUBLICPÚBLICO

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

Page 49: 355a de soluciones cXML - help.sap.com

Cuentas de prueba

Las aplicaciones cXML deben soportar tanto cuentas en productivo Ariba Network como cuentas de prueba Ariba Network. Las cuentas de prueba son utilizadas por las organizaciones durante el desarrollo de sus aplicaciones para mantener los datos de prueba separados de los datos en productivo.

Las aplicaciones de SAP Ariba tienen en cuenta que las cuentas de prueba deben estar totalmente separadas de las cuentas de producción.

Para dar nombre a los ID de organización para cuentas de prueba añada “-T” al string de ID.

Ejemplo

<Credential domain="DUNS"> <Identity>942888711-T</Identity> </Credential> <Credential domain="NetworkID"> <Identity>AN6565656565-T</Identity> </Credential>

Las aplicaciones no deben hacer diferenciación alguna entre “-T” y “-t”; no deben diferenciar entre mayúsculas y minúsculas.

Credenciales obligatorias

Todo documento cXML enrutado a un servidor cXML debe contener credenciales específicas en la sección Header. Las credenciales se especifican en los elementos From, To y Sender. Permiten a los sistemas receptores identificar, autentificar y autorizar partes.

Cuando los documentos cXML llegan a sus destinos, los nodos intermediarios (como Ariba Network) cambian el elemento Sender. El elemento Sender siempre especifica el nodo más reciente de la cadena de transmisión.

Credenciales Ariba Buyer [página 49]

Ariba Marketplace, Standar Edition [página 52]

Proveedores de servicios [página 53]

Credenciales de proveedor [página 54]

Credenciales Ariba Buyer

Las credenciales se utilizan en transacciones entre Ariba Buyer, proveedores y Ariba Network.

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

PUBLICPÚBLICO 49

Page 50: 355a de soluciones cXML - help.sap.com

Comprador a proveedor

● OrderRequest● PunchOutSetupRequest

Elemento Contenido

From Ariba Buyer

To Proveedor

Sender Ariba Buyer

Para obtener más información sobre las restricciones de credenciales de las versiones anteriores de Ariba Buyer, consulte ID de Ariba Network y versiones anteriores de Ariba Buyer [página 47].

Ejemplo

<From> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> </Credential></From><To> <Credential domain="DUNS"> <Identity>942888711</Identity> </Credential></To><Sender> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Ariba Buyer 7.0.6</UserAgent> </Sender>

Comprador para Ariba Network

● GetPendingRequest

● SubscriptionContentRequest SubscriptionListRequest SubscriptionStatusUpdateRequest SupplierListRequest SupplierDataRequest OrderStatusSetupRequest

Elemento Contenido

From Ariba Buyer

To Ariba Network

50PUBLICPÚBLICO

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

Page 51: 355a de soluciones cXML - help.sap.com

Elemento Contenido

Sender Ariba Buyer

Ejemplo

<From> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> </Credential></From><To> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> </Credential></To><Sender> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Ariba Buyer 7.1</UserAgent> </Sender>

PunchIn de proveedores

Ariba Buyer 8.1 y posteriores con el portal de PunchIn de proveedores acepta documentos cXMLProfileRequest enviados por Ariba Network.

● ProfileRequest

Elemento Contenido

From Ariba Network

To Ariba Buyer

Sender Ariba Network

Ejemplo

<From> <Credential domain="NetworkID"> <Identity>AN10000001</Identity> </Credential></From><To> <Credential domain="NetworkID"> <Identity>AN100000123</Identity> </Credential>

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

PUBLICPÚBLICO 51

Page 52: 355a de soluciones cXML - help.sap.com

</To><Sender> <Credential domain="NetworkID"> <Identity>AN10000001</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Ariba Network</UserAgent> </Sender>

Ariba Marketplace, Standar Edition

Las credenciales se necesitan en transacciones entre Ariba Marketplace, Standard Edition (AM-SE), proveedores y Ariba Network.

Proveedor a Marketplace

● ProviderSetupRequest durante configuración● OrderStatusSetupRequest

Elemento Contenido

From Proveedor

To Ariba Network

Sender Marketplace

Marketplace a proveedor

● PrivateOrganizationRequest

Elemento Contenido

From Marketplace

To Ariba Network

Sender Marketplace

Ejemplo

<From> <Credential domain="NetworkID"> <Identity>AN6565656565</Identity> <!-- identity of the marketplace --> </Credential></From>

52PUBLICPÚBLICO

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

Page 53: 355a de soluciones cXML - help.sap.com

<To> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> </Credential></To><Sender> <Credential domain="NetworkID"> <Identity>AN6565656565</Identity> <SharedSecret>abracadabra</SharedSecret> <!-- shared secret of marketplace --> </Credential> <UserAgent>Ariba Marketplace 7.5</UserAgent> </Sender>

El pedido ha sido transmitido al proveedor por Ariba Network mediante PunchOut.

Proveedores de servicios

Las credenciales son obligatorias en transacciones entre proveedores de servicios, proveedores y Ariba Network.

Proveedor a proveedor de servicios

● ProviderSetupRequest durante configuración

Elemento Contenido

From Proveedor

To Proveedor de servicios

Sender Ariba Network

Ejemplo

<From> <!-- Supplier's identity --> Credential domain="NetworkID"> <Identity lastChangedTimestamp="2000-03-12T18:39:09-08:00"> AN01333333333 </Identity> </Credential></From><To> <!-- Service provider's identity --> Credential domain="NetworkID"> <Identity>AN01222222222</Identity> </Credential></To><Sender> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential>

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

PUBLICPÚBLICO 53

Page 54: 355a de soluciones cXML - help.sap.com

<UserAgent>Ariba Network v20</UserAgent> </Sender>

Credenciales de proveedor

Las credenciales son obligatorias en transacciones entre proveedores y Ariba Network.

Proveedor para Ariba Network

● GetPendingRequest● ProfileRequest ● CatalogUploadRequest

Elemento Contenido

From Proveedor

To Ariba Network

Sender Proveedor

Ejemplo

<From> <Credential domain="NetworkID"> <Identity>AN10000000123</Identity> </Credential></From><To> <Credential domain="NetworkID"> <Identity>AN01000000001</Identity> </Credential></To><Sender> <Credential domain="NetworkID"> <Identity>AN10000000123</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Our order-receiving system 3.0</UserAgent> </Sender>

Ariba Network a proveedor

● ProfileRequest iniciado por Ariba Network

54PUBLICPÚBLICO

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

Page 55: 355a de soluciones cXML - help.sap.com

Elemento Contenido

From Ariba Network

To Proveedor

Sender Ariba Network

Ejemplo

<From> <Credential domain="NetworkID"> <Identity>AN01000000001</Identity> </Credential></From><To> <Credential domain="NetworkID"> <Identity>AN10000000123</Identity> </Credential></To><Sender> <Credential domain="NetworkID"> <Identity>AN01000000001</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Ariba Network</UserAgent> </Sender>

Comprador a proveedor

● ProfileRequest iniciado por el comprador● OrderRequest ● StatusUpdateRequest ● PaymentRemittanceRequest ● TimeCardRequest

Elemento Contenido

From Comprador

To Proveedor

Sender Ariba Network

Ejemplo

<From> <Credential domain="NetworkID">

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

PUBLICPÚBLICO 55

Page 56: 355a de soluciones cXML - help.sap.com

<Identity>AN01000000456</Identity> </Credential></From><To> <Credential domain="NetworkID"> <Identity>AN10000000123</Identity> </Credential></To><Sender> Credential domain="NetworkID"> <Identity>AN01000000001</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Ariba Network</UserAgent> </Sender>

Proveedor a comprador

● ConfirmationRequest ● ShipNoticeRequest ● InvoiceDetailRequest ● TimeCardRequest

Elemento Contenido

From Proveedor

To Comprador

Sender Proveedor

Ejemplo

<From> <Credential domain="NetworkID"> <Identity>AN10000000123</Identity> </Credential></From><To> <Credential domain="NetworkID"> <Identity>AN01000000456</Identity> </Credential></To><Sender> <Credential domain="NetworkID"> <Identity>AN10000000123</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Our order-receiving system 3.0</UserAgent> </Sender>

56PUBLICPÚBLICO

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

Page 57: 355a de soluciones cXML - help.sap.com

Integración de extremos con adaptadores Ariba NetworkEl adaptador cXML soporta la integración de extremos para las siguientes soluciones para el adaptador Ariba Network de Oracle® Fusion Middleware, el adaptador Ariba Network de SAP NetWeaver®, Ariba Network Transport Adapter, SAP Ariba Buying and Invoicing™ y SAP Ariba Buying™.

Los adaptadores de Ariba Network permiten el intercambio de datos entre su sistema ERP externo y Ariba Network. Si ha configurado un extremo para su sistema ERP externo en Ariba Network, deberá actualizar la información sobre el extremo en el archivo de configuración del canal del correspondiente adaptador de Ariba Network.

NotaUn extremo sólo es aplicable a documentos salientes enviados desde su sistema ERP a Ariba Network.

Cuando su adaptador de Ariba Network recibe un documento saliente de su sistema ERP externo, el adaptador de red anexa la información sobre el extremo al cXML y después publica el documento en Ariba Network. Así por ejemplo, cuando se crea la cabecera cXML para un pedido de compra su adaptador de red verifica si la información sobre el extremo está actualizada en el archivo de configuración del canal.

Si crea un pedido de compra mediante una solución de compras Ariba y lo envía a un proveedor a través de Ariba Network, la información sobre el extremo se anexa al cXML y después el documento se publica en Ariba Network. SAP Ariba efectúa una verificación para ver si la información sobre el extremo se ha actualizado como parte del perfil de su sitio.

Nota: Si configura un extremo para su solución de compras SAP Ariba en Ariba Network, asegúrese de trabajar con su representante del servicio de asistencia de SAP Ariba para actualizar la información sobre el extremo como parte del perfil del sitio de su organización.

El adaptador de red o la solución de compras incluye el extremo en la cabecera cXML como parte del elemento From tal y como se explica más adelante:

<Header> <From> <Credential domain="NetworkId"> <Identity>AN02000076701</Identity> </Credential> <Credential domain="SystemID"> <Identity>ARB2</Identity> </Credential> <Credential domain="EndPointID"> <Identity>ERPEndPoint1</Identity> </Credential> </From> <To> <Credential domain="NetworkID"> <Identity>AN02000076720</Identity> </Credential> </To> <Sender> <Credential domain="NetworkID"> <Identity>AN02000076701</Identity> <SharedSecret>sharedsecret</SharedSecret> /Credential> <UserAgent>Buyer</UserAgent> </Sender></Header>

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

PUBLICPÚBLICO 57

Page 58: 355a de soluciones cXML - help.sap.com

<Request> OrderRequest>……

ERPEndPoint1 es el valor que ha configurado en el canal de comunicación en SAP NetWeaver o en el archivo de configuración del canal.

NotaEn una configuración de ERP sencilla, no es necesario que incluya el ID de sistema en la credencial <From> .

Configuración de un parámetro de configuración de extremo para los adaptadores de Ariba Network [página 58]

Cómo activar la integración de extremos para documentos salientes [página 58]

Activación de la integración de extremo para Ariba Network Adapter for SAP NetWeaver [página 59]

Integración de extremos en una configuración ERP múltiple [página 59]

Configuración de un parámetro de configuración de extremo para los adaptadores de Ariba Network

Se puede agregar un parámetro de configuración denominado endpoint al archivo de configuración del canal para capturar la información del extremo que ha configurado en Ariba Network para su sistema ERP externo. Este parámetro es opcional. Fíjelo únicamente si ha configurado un extremo para su sistema ERP extremo en Ariba Network.

NotaEste procedimiento es aplicable sólo al Ariba Network Adapter for Oracle Fusion Middleware y el Ariba Network Transport Adapter.

Cómo activar la integración de extremos para documentos salientes

Puede habilitar la integración de extremos para documentos salientes.

Procedimiento

1. Abra el archivo de configuración del canal para el adaptador correspondiente.2. Especifique valores para los parámetros relevantes.3. Guarde el archivo de configuración del canal.

58PUBLICPÚBLICO

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

Page 59: 355a de soluciones cXML - help.sap.com

Activación de la integración de extremo para Ariba Network Adapter for SAP NetWeaver

En el Configurador modelo, abra el canal de comunicación relevante para la transacción saliente que está configurando. En Canal de comunicación, doublERPEndPoint1 es el valor que ha configurado en el canal de comunicación en SAP NetWeaver o en el archivo de configuración del canal.

NotaEn una configuración de ERP sencilla, no es necesario que incluya el ID de sistema en la credencial <From>.

Integración de extremos en una configuración ERP múltiple

Si su cuenta se ha activado para varios ERP externos y para el soporte de extremos en Ariba Network, deberá crear ID de sistema correspondientes a los distintos sistemas ERP, así como un extremo para cada ID de sistema.

Para los documentos enviados desde Ariba Network al ERP, el adaptador de red utiliza el ID de sistema para identificar los sistemas ERP que reciben esos documentos. Por tanto es suficiente con crear sólo un extremo con el mismo nombre para todos los ID de sistema.

Cuando se crea la cabecera cXML para un pedido de compra, su adaptador de red verifica si la información sobre el extremo está actualizada en el archivo de configuración del canal o en el canal de comunicación en SAP NetWeaver. Si es así, el adaptador de red incluye el extremo en la cabecera cXML junto con el ID de sistema.

Ejemplo

<Header> <From> <Credential domain="NetworkId"> <Identity>AN02000076701</Identity> </Credential> <Credential domain="SystemId"> <Identity>ARB2</Identity> </Credential> <Credential domain="EndPointID"> <Identity>ERPEndPoint1</Identity> </Credential> </From> <To> <Credential domain="NetworkID"> <Identity>AN02000076720</Identity> </Credential> </To> <Sender> <Credential domain="NetworkID"> <Identity>AN02000076701</Identity> <SharedSecret>welcome1a</SharedSecret> </Credential> <UserAgent>Buyer</UserAgent> </Sender></Header><Request>

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

PUBLICPÚBLICO 59

Page 60: 355a de soluciones cXML - help.sap.com

<OrderRequest>……

ERPEndPoint1 es el valor que ha configurado en el canal de comunicación en SAP NetWeaver o en el archivo de configuración del canal y ARB2 es el ID de sistema.

Enrutamiento de pedidos para territorios secundarios en una configuración de varios sistemas ERP

Las organizaciones con territorios secundarios en una configuración de varios sistemas ERP que enrutan pedidos de compra hacia ERP y desde ERP a Spot Buy deben agregar una credencial ChildSystemID a la etiqueta From del cXML del pedido de compra.

Las credenciales se deben colocar en el orden siguiente: NetworkID en la parte superior, seguida de SystemID y, a continuación, de ChildSystemId.

Ejemplo:

<From> <Credential domain="NetworkID"> <Identity>AN01427018393-T</Identity> </Credential> <Credential domain="SystemID"> <Identity>Q01CLNT600</Identity> </Credential> <Credential domain="ChildSystemId"> <Identity>[child_ID]</Identity> </Credential> </From>

child_ID es el systemID para el sitio secundario que ha creado la solicitud de compra.

Activación rápidaLa activación rápida de Ariba Network permite a las organizaciones compradoras y a los proveedores del servicio de conversión de facturas (ICS) crear nuevas cuentas de Ariba Network en nombre de proveedores.

Los compradores crean esas cuentas especificando la información de la empresa del proveedor en un elemento Correspondent en la cabecera de pedidos de compras, facturas, propuestas de pago, facturas CC (facturas enviadas desde la solución de compras de SAP Ariba o el sistema ERP) y solicitudes de colaboración al proveedor o facturas procedentes del proveedor. Ariba Network utiliza esta información para crear la cuenta del proveedor.

Las cuentas de la organización compradora o el proveedor de servicios deben estar habilitadas para la activación rápida. La activación rápida de ICS debe estar habilitada por el servicio de asistencia de SAP Ariba. Ariba Network ignora el elemento Correspondent para cuentas que no se han habilitado.

El elemento Correspondent está disponible en cXML 1.2.016 o posteriores. Especifica la información de la empresa del proveedor con un elemento Contact y opcionalmente puede utilizar un atributo preferredLanguage para indicar el idioma preferido del proveedor. Todos los documentos que Ariba Network envíe al proveedor estarán en ese idioma, siempre que esté soportado. Si preferredLanguage no se ha

60PUBLICPÚBLICO

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

Page 61: 355a de soluciones cXML - help.sap.com

especificado o si se refiere a un idioma que no se soporta, Ariba Network enviará los documentos al proveedor en inglés.

Los siguientes son los tipos de documentos que se pueden utilizar para la activación rápida:

● Pedidos de compra (véase Utilización de pedidos de compra [página 61])● Facturas (véase Utilización de facturas ICS [página 63])● Propuestas de pago (véase Utilización de propuestas de pago [página 65])● Facturas CC (facturas enviadas desde la solución de compras Ariba o el sistema ERP) (véase Utilización de

facturas CC [página 67])● Solicitud de oferta (véase Utilización de solicitudes de oferta [página 69])● ID fiscales (véase Utilización de los ID fiscales [página 71])

Utilización de pedidos de compraLas aplicaciones de compras agregan el elemento Correspondent a pedidos de compra para crear cuentas Ariba Network para proveedores y enviarles pedidos de compra por correo electrónico o fax.

El siguiente ejemplo muestra la cabecera de un pedido de compra para activación rápida:

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM"http://xml.cxml.org/schemas/cXML/1.2.016/cXML.dtd"><cXML payloadID="125xyzkjlkwx" timestamp="2006-04-20T23:59:45-07:00"> <Header> <From> <Credential domain="NetworkID"> <Identity>AN20000000123</Identity> <!-- ID of buyer --> </Credential> </From> <To> <Credential domain="PrivateId"> <Identity>SupplierABC</Identity> <!-- ID of new supplier--> </Credential> <Correspondent preferredLanguage="en-US"> <Contact role="correspondent"> <Name>ACME Supply, Inc.</Name> <PostalAddress name="default"> Street>123 Main Street</Street> <Street>Suite 101</Street> <City>Beamont</City> <State>TX</State> <PostalCode>77705</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> <Email name="routing">[email protected]</Email> <!—- Email address for routing the PO --> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode>650</AreaOrCityCode> <Number>1234567</Number> </TelephoneNumber> </Phone> <Fax name="routing"> <!—Fax number for routing the PO --> <TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode>650</AreaOrCityCode> <Number>5555555</Number> </TelephoneNumber>

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

PUBLICPÚBLICO 61

Page 62: 355a de soluciones cXML - help.sap.com

</Fax> </Contact> </Correspondent> </To> <Sender> <Credential domain="NetworkID"> <Identity>AN20000000123</Identity> <!-- ID of buyer --> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Our Procurement App V2.0</UserAgent> </Sender> </Header>

Cómo las organizaciones compradoras especifican ID de proveedor

Las organizaciones compradoras utilizan el dominio PrivateId en To Credential para identificar al proveedor. Las organizaciones compradoras que utilizan Soluciones de SAP Ariba Procurement también utilizan los dominios VendorID, VendorSiteID y SSPPrivateID.

Ariba Network asigna al proveedor un NetworkID (ANID), pero la organización compradora puede continuar utilizando los otros dominios [página 44] en documentos posteriores.

Cómo las organizaciones compradoras especifican el enrutamiento

Las organizaciones compradoras incluyen la dirección de correo electrónico o el número de fax del proveedor en el elemento Contact para indicar a Ariba Network cómo enrutar el pedido de compra. El elemento Email o Fax debe tener un atributo name="routing".

Ariba Network rechaza los pedidos de compra que no proporcionan el atributo name="routing".

NotaSi las organizaciones compradoras proporcionan tanto el elemento Email como el elemento Fax, Ariba Network rechaza los pedidos de compra debido a un conflicto en la información de enrutamiento.

Aceptación de la propiedad de cuentas

Ariba Network envía el pedido de compra al proveedor junto con una invitación para iniciar sesión y completar el proceso de registro. Ariba Network anima a los proveedores a aceptar la propiedad de las cuentas.

Si la organización compradora utiliza la función de cuenta predeterminada de Ariba Network para activar a los proveedores, el proveedor registrará una cuenta predeterminada en Ariba Network. Si la organización compradora no utiliza el método de cuenta predeterminada, el proveedor registra una cuenta Enterprise.

NotaLos pedidos de compra de activación rápida enviados a las cuentas predeterminadas no están sujetos a las cuotas de proveedor. Los pedidos de compra de activación rápida enviados a las cuentas Enterprise están

62PUBLICPÚBLICO

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

Page 63: 355a de soluciones cXML - help.sap.com

sujetos a las cuotas de proveedor. En relación con las cuentas Enterprise, si los proveedores no se registran y pagan la cuota necesaria en caso de convertirse en proveedores sujetos a cargo, Ariba Network rechaza los pedidos de compra dirigidos a ellos. Para obtener más información sobre los umbrales de cuotas de proveedor, consulte la página de suscripciones y precios .

Ariba Network utiliza los datos en el elemento Contact para completar los campos en la cuenta del proveedor. Son obligatorios los elementos Name, Street, City y Country del elemento Contact.

Una vez que el proveedor ha iniciado sesión y ha aceptado la propiedad de la cuenta, Ariba Network ignora cualquier elemento Correspondent en los siguientes pedidos de compra enviados a ese proveedor, ya que este puede haber fijado valores de cuenta, como un método de enrutamiento preferido, el nombre de la empresa o la dirección de la empresa.

Utilización de facturas ICS

Los prestatarios del servicio de conversión de facturas (ICS) agregan el elemento Correspondent a facturas para crear cuentas Ariba Network para proveedores.

NotaPara obtener información detallada sobre facturas ICS y el proceso de conversión de facturas, consulte la Ariba Network guide to invoice conversion.

El siguiente ejemplo muestra la cabecera de una factura ICS para activación rápida:

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM"http://xml.cxml.org/schemas/cXML/1.2.016/InvoiceDetail.dtd"><cXML payloadID="125xyzkjlkwx" timestamp="2006-04-20T23:59:45-07:00"> <Header> <From> <Credential domain="ProviderId"> <Identity>supplier123</Identity> <!-- ID of new supplier --> </Credential> <Correspondent preferredLanguage="en-US"> <Contact role="correspondent"> <Name>ACME Supply, Inc.</Name> <PostalAddress name="default"> <Street>123 Main Street</Street> <Street>Suite 101</Street> <City>Beamont</City> <State>TX</State> <PostalCode>77705</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> <Email name="routing">[email protected]</Email> <!—- Email address for routing the Invoice--> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode>650</AreaOrCityCode> <Number>1234567</Number> </TelephoneNumber> </Phone> <Fax name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode>

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

PUBLICPÚBLICO 63

Page 64: 355a de soluciones cXML - help.sap.com

<AreaOrCityCode>650</AreaOrCityCode> <Number>1234567</Number> </TelephoneNumber> </Fax> </Contact> </Correspondent> </From> <To> <Credential domain="NetworkID"> <Identity>AN20000000123</Identity> <!-- ID of buyer --> </Credential> </To> <Sender> <Credential domain="NetworkID"> <Identity>AN200000777</Identity> <!-- ID of service provider --> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Nifty Invoice Scanning V2.0</UserAgent> </Sender> </Header>

Cómo especifican los proveedores de servicios ID de proveedor

Los proveedores de servicios identifican proveedores con el dominio PrivateId o ProviderId en el elemento From.

● El dominio PrivateId se utiliza si el proveedor ya existe.● El dominio ProviderId se utiliza si el proveedor de servicios no puede hacer coincidir el proveedor de la

factura en papel con un proveedor en el informe del pedido de compra de la organización o el archivo maestro del suministrador. La primera vez que el proveedor de servicios utiliza un ID de proveedor en concreto, Ariba Network envía la factura a la página Facturas sin asignar de la cuenta Ariba Network de la organización compradora. Ariba Network utiliza el proceso de activación rápida para crear una cuenta de proveedor privada para el proveedor.

Aceptación de la propiedad de cuentas

Los proveedores deben ponerse en contacto con el servicio de asistencia de SAP Ariba para aceptar la propiedad de cuentas de activación rápida creadas mediante facturación.

Si la organización compradora utiliza la función de cuenta predeterminada de Ariba Network para activar a los proveedores, el proveedor registrará una cuenta predeterminada en Ariba Network. Si la organización compradora no utiliza el método de cuenta predeterminada, el proveedor registrará una cuenta de uso completo.

Ariba Network utiliza los datos en el elemento Contact para completar los de la cuenta del proveedor. Son obligatorios los elementos Name, Street, City y Country del elemento Contact.

64PUBLICPÚBLICO

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

Page 65: 355a de soluciones cXML - help.sap.com

Utilización de propuestas de pago

Las aplicaciones de compras utilizan el elemento Correspondent en propuestas de pago para crear cuentas Ariba Network para proveedores y enviarles las propuestas de pago por correo electrónico.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM"http://xml.cxml.org/schemas/cXML/1.2.016/cXML.dtd"><cXML payloadID="125xyzkjlkwx" timestamp="2006-04-20T23:59:45-07:00"> <Header> <From> <Credential domain="NetworkID"> <Identity>AN20000000123</Identity> <!-- ID of buyer --> </Credential> </From> <To> <Credential domain="PrivateId"> <Identity>SupplierABC</Identity> <!-- ID of new supplier--> </Credential> <Correspondent preferredLanguage="en-US"> <Contact role="correspondent"> <Name>ACME Supply, Inc.</Name> <PostalAddress name="default"> <Street>123 Main Street</Street> <Street>Suite 101</Street> <City>Beamont</City> <State>TX</State> <PostalCode>77705</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> <Email name="routing">[email protected]</Email> <!—- Email address for routing the Payment Proposal --> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode>650</AreaOrCityCode> <Number>1234567</Number> </TelephoneNumber> </Phone> </Contact> </Correspondent> </To> <Sender> <Credential domain="NetworkID"> <Identity>AN20000000123</Identity> <!-- ID of buyer --> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Our Procurement App V2.0</UserAgent> </Sender> </Header>

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

PUBLICPÚBLICO 65

Page 66: 355a de soluciones cXML - help.sap.com

Cómo las organizaciones compradoras especifican ID de proveedor

Las organizaciones compradoras identifican proveedores con el dominio PrivateId en To Credential. Las organizaciones compradoras que utilizan Soluciones de SAP Ariba Procurement también utilizan los dominios VendorID, VendorSiteID y SSPPrivateID.

Ariba Network asigna al proveedor un NetworkID (ANID), pero la organización compradora puede continuar utilizando los otros dominios [página 44] en documentos posteriores.

Cómo las organizaciones compradoras especifican el enrutamiento

Las organizaciones compradoras únicamente pueden incluir la dirección de correo electrónico del proveedor en el elemento Contact para indicar a Ariba Network cómo enrutar la propuesta de pago. El elemento Email debe tener un atributo name="routing".

Ariba Network rechaza los pedidos de compra que no proporcionan el atributo name="routing".

Nota● Ariba Network no soporta el elemento fax en propuestas de pago.● Si las organizaciones compradoras proporcionan tanto el elemento Email como el elemento Fax, Ariba

Network rechaza las propuestas de pago debido a un conflicto en la información de enrutamiento.● Si el proveedor rechaza aceptar la propiedad de la cuenta, la organización compradora no podrá enviar

propuestas de pago adicionales a ese proveedor a través de Ariba Network.● Ariba Network solo soporta la versión cXML 1.2.016 y posteriores para propuestas de pago de activación

rápida.● Ariba Network no soporta adjuntos en propuestas de pago. Si una propuesta de pago contiene un adjunto,

Ariba Network lo ignora pero procesa la propuesta de pago.

Cómo los proveedores privados aceptan la propiedad de cuentas

Ariba Network envía una invitación al proveedor privado para que inicie sesión y complete el proceso de registro. Ariba Network anima a los proveedores privados a aceptar la propiedad de las cuentas.

Si la organización compradora utiliza la función de cuenta predeterminada de Ariba Network para activar a los proveedores, el proveedor registrará una cuenta predeterminada en Ariba Network. Si la organización compradora no utiliza el método de cuenta predeterminada, el proveedor registra una cuenta Enterprise.

Una vez que el proveedor privado inicia sesión y acepta la propiedad de la cuenta, el proveedor puede ver la propuesta de pago. Todas las notificaciones posteriores relativas a las propuestas de pago se envían al proveedor por correo electrónico.

Ariba Network utiliza los datos en el elemento Contact para completar los campos en la cuenta del proveedor.

Las propuestas de pago de activación rápida no están sujetas a las cuotas de proveedor. Para obtener más información sobre los umbrales de cuotas de proveedor, consulte la página de suscripciones y precios .

66PUBLICPÚBLICO

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

Page 67: 355a de soluciones cXML - help.sap.com

Utilización de facturas CCUna factura CC es una documento de solicitud de copia cXML que contiene una factura adjunta enviada desde Soluciones de SAP Ariba Procurement o el sistema ERP. La activación rápida mediante facturas CC debe estar activada en la cuenta Ariba Network del comprador.

Ariba Network archiva una copia de la factura procedente del sistema ERP. A continuación, los proveedores pueden iniciar sesión en su cuenta de Ariba Network y ver el estado de sus facturas y supervisar el progreso de la factura a través del proceso de reconciliación de factura.

Los sistemas externos utilizan el elemento Correspondent en facturas CC para crear cuentas de Ariba Network para proveedores aún no registrados en Ariba Network y enviarles las cartas de bienvenida por correo electrónico.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM"http://xml.cxml.org/schemas/cXML/1.2.016/cXML.dtd"><cXML payloadID="125xyzkjlkwx" timestamp="2006-04-20T23:59:45-07:00"> <Header> <From> <Credential domain="NetworkID"> <Identity>AN20000000123</Identity> <!-- ID of buyer --> </Credential> </From> <To> <Credential domain="PrivateId"> <Identity>SupplierABC</Identity> <!-- ID of new supplier--> </Credential> <Correspondent preferredLanguage="en-US"> <Contact role="correspondent"> <Name>ACME Supply, Inc.</Name> <PostalAddress name="default"> <Street>123 Main Street</Street> <Street>Suite 101</Street> <City>Beamont</City> <State>TX</State> <PostalCode>77705</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> <Email name="routing">[email protected]</Email> <!—- Email address for routing the CC Invoice--> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode>650</AreaOrCityCode> <Number>1234567</Number> </TelephoneNumber> </Phone> </Contact> </Correspondent> </To> <Sender> <Credential domain="NetworkID"> Identity>AN20000000123</Identity> <!-- ID of buyer --> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Our Procurement App V2.0</UserAgent> </Sender> </Header>

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

PUBLICPÚBLICO 67

Page 68: 355a de soluciones cXML - help.sap.com

Cómo las organizaciones compradoras especifican ID de proveedor

Las organizaciones compradoras identifican proveedores con el dominio PrivateId en To Credential. Las organizaciones compradoras que utilizan Soluciones de SAP Ariba Procurement también utilizan los dominios VendorID, VendorSiteID y SSPPrivateID.

Ariba Network asigna al proveedor un NetworkID (ANID), pero la organización compradora puede continuar utilizando los otros dominios [página 44] en documentos posteriores.

Cómo las organizaciones compradoras especifican el enrutamiento

Las organizaciones compradoras únicamente pueden incluir la dirección de correo electrónico del proveedor en el elemento Contact para indicar a Ariba Network cómo enrutar la factura CC. El elemento Email debe tener un atributo name="routing".

Ariba Network rechaza los pedidos de compra que no proporcionan el atributo name="routing".

Nota● Ariba Network no soporta el elemento fax para facturas CC enviadas desde Soluciones de SAP Ariba

Procurement o el sistema ERP.● Si las organizaciones compradoras proporcionan tanto el elemento Email como el elemento Fax, Ariba

Network rechaza las facturas CC debido a un conflicto en la información de enrutamiento.● Si el proveedor rechaza aceptar la propiedad de la cuenta, la organización compradora no podrá enviar

facturas CC adicionales a ese proveedor a través de Ariba Network.● Ariba Network solo soporta la versión cXML 1.2.016 y posteriores para facturas CC de activación rápida.● Ariba Network permite adjuntos en las facturas CC enviadas desde Soluciones de SAP Ariba Procurement

o sistemas ERP.● Las organizaciones de compras deben personalizar sus aplicaciones de CI si desean utilizar CI para

transferir adjuntos como facturas CC.

Cómo los proveedores privados aceptan la propiedad de cuentas

Ariba Network envía una invitación al proveedor privado para que inicie sesión y complete el proceso de registro. Ariba Network anima a los proveedores privados a aceptar la propiedad de las cuentas.

Si la organización compradora utiliza la función de cuenta predeterminada de Ariba Network para activar a los proveedores, el proveedor registrará una cuenta predeterminada en Ariba Network. Si la organización compradora no utiliza el método de cuenta predeterminada, el proveedor registrará una cuenta de uso completo.

Una vez que el proveedor privado inicia sesión y acepta la propiedad de la cuenta, el proveedor puede ver las facturas CC enviadas desde Soluciones de SAP Ariba Procurement o el sistema ERP. Todas las notificaciones posteriores relativas a las facturas CC se envían al proveedor por correo electrónico.

Ariba Network utiliza los datos en el elemento Contact para completar los de la cuenta del proveedor.

68PUBLICPÚBLICO

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

Page 69: 355a de soluciones cXML - help.sap.com

Las facturas CC de activación rápida enviadas desde Soluciones de SAP Ariba Procurement o el sistema ERP solo están sujetas a las cuotas de proveedor si el proveedor privado ha aceptado la propiedad de una cuenta de uso completo en Ariba Network. Los proveedores privados que aún no han aceptado la propiedad de su cuenta pueden continuar recibiendo facturas CC sin que se les realice ningún cargo. Para obtener más información sobre los umbrales de cuotas de proveedor, consulte la página de suscripciones y precios .

Utilización de solicitudes de oferta

Las aplicaciones de compras agregan el elemento Correspondent al documento quoteRequest para crear Ariba Network cuentas para proveedores.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/schemas/cXML/1.2.025/Quote.dtd"><cXML payloadID="123@jnk" timestamp="2013-11-19T11:50:11+00:00" version="1.2.025"><Header> <From> <Credential domain="NetworkId"> Identity>AN02000533043</Identity> </Credential> </From> <To> <Credential domain="NetworkId"> <Identity>AN02000533043</Identity> </Credential> </To> <Sender> <Credential domain="NetworkID"> <Identity>AN02000533043</Identity> <SharedSecret>sharedsecret</SharedSecret> </Credential> <UserAgent>Procurement App 2.0</UserAgent> </Sender></Header><Request deploymentMode="production"> <QuoteRequest> <QuoteRequestHeader requestID="2021.2215" requestDate="2014-03-06T23:25:01.000-07:00" type="new" openDate="2014-03-10T23:13:49.000-07:00" currency="USD" xml:lang="en" loseDate="2014-03-17T00:00:00.000-07:00" quoteReceivingPreference="winningOnly" > <SupplierSelector matchingType="invitationOnly"> <SupplierInvitation> <OrganizationID> <Credential domain="VendorID"> <Identity>2210</Identity> </Credential> </OrganizationID> <Correspondent> <Contact> <Name xml:lang="en">New Inv Inc</Name> <PostalAddress> <DeliverTo>922 West</DeliverTo> <Street>15th Avenue</Street> <City>California</City>

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

PUBLICPÚBLICO 69

Page 70: 355a de soluciones cXML - help.sap.com

<State>CA</State> <PostalCode>93504</PostalCode> <Country isoCountryCode="US"></Country> </PostalAddress> <Email>[email protected]</Email> <Phone> <TelephoneNumber> <CountryCode isoCountryCode="US"></CountryCode> <AreaOrCityCode>ca</AreaOrCityCode> <Number>2342344</Number> </TelephoneNumber> </Phone> <URL></URL> </Contact> </Correspondent> </SupplierInvitation> </SupplierSelector> <Description xml:lang="" >Quote for AS1</Description> <ShipTo> <Address isoCountryCode="US" addressID="409" > <Name xml:lang="en" >P2- Los Angeles</Name> <PostalAddress name="P2- Los Angeles" > <Street>1022 Sepulveda Blvd</Street> <Street>Suite 1000Address2</Street> <Street>Address3</Street> <City>El Segundo</City> <State>California</State> <PostalCode>90245</PostalCode> <Country isoCountryCode="US" >United States</Country> </PostalAddress> <Phone> <TelephoneNumber> <CountryCode isoCountryCode="US" /> <AreaOrCityCode/> <Number/> </TelephoneNumber> </Phone> <Fax> <TelephoneNumber> <CountryCode isoCountryCode="US" /> <AreaOrCityCode/> <Number/> </TelephoneNumber> </Fax> </Address> </ShipTo> </QuoteRequestHeader> </QuoteRequest> </Request>

Cómo utilizan las organizaciones compradoras los ID de organizaciones de proveedores

Las organizaciones compradoras utilizan el elemento Correspondent para almacenar la información de contacto del proveedor. Ariba Network utiliza el OrganizationID en el documento quoteRequest para identificar si el proveedor es nuevo o ya existía.

En el caso de los dominios SAP, Oracle y PeopleSoft, la organización compradora identifica a los proveedores mediante los dominios NetworkID o VendorID, VendorSiteID y SiteAuxID.

70PUBLICPÚBLICO

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

Page 71: 355a de soluciones cXML - help.sap.com

Si el proveedor no existe en Ariba Network, la información de contacto se utiliza para enviar la carta de oferta en la que se invita al proveedor a registrarse y contestar a la comunicación de la solicitud de oferta (RFQ) en SAP Ariba Discovery.

Para obtener más información sobre dominios de Credential, consulte Dominios de ID soportados [página 44].

Cómo las organizaciones compradoras especifican el enrutamiento del correo electrónico

Las organizaciones compradoras pueden incluir la dirección de correo electrónico del proveedor en el elemento Contact para indicar a SAP Ariba Discovery adónde debe enviar la carta en la que se invita al proveedor a que presente una oferta.

Nota● Ariba Network soporta la versión cXML 1.2.025 y posteriores para la activación rápida a través de

solicitudes de oferta.● Ariba Network soporta adjuntos y comentarios en el documento RFQ.

Cómo SAP Ariba Discovery invita a los proveedores privados a aceptar la propiedad de cuentas

Si el proveedor no existe, SAP Ariba Discovery envía la invitación de automatización de ofertas al proveedor privado para completar el proceso de registro.

Una vez que el proveedor privado inicia sesión y acepta la propiedad de la cuenta, el proveedor puede iniciar sesión para ver la comunicación de solicitud de oferta (RFQ) del comprador. Todas las notificaciones posteriores relativas al documento RFQ se envían al proveedor por correo electrónico.

Ariba Network utiliza los datos en el elemento Contact para completar los de la cuenta del proveedor.

Utilización de los ID fiscales

Los ID fiscales solo pueden aplicarse a compradores y proveedores configurados para la activación rápida mediante ID fiscales utilizando facturas XML enviadas desde Brasil. Para habilitar esta función, un comprador debe ponerse en contacto con el servicio de asistencia de SAP Ariba y configurar sus ID fiscales.

Una vez configurados, los compradores pueden ver desde su cuenta Ariba Network los ID fiscales para su organización.

Un proveedor envía una factura NFe, CTe y CCe a un comprador a través de Ariba Network en un formato XML. Estas facturas pueden enviarse a través de un correo electrónico o publicarse en Ariba Network, donde se convierten en el archivo cXML. Para obtener más información sobre el envío de estas facturas, póngase en contacto con el servicio de asistencia de SAP Ariba.

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

PUBLICPÚBLICO 71

Page 72: 355a de soluciones cXML - help.sap.com

Nota● Ariba Network acepta y procesa las facturas NFe únicamente si el comprador tiene un ID fiscal configurado

en Ariba Network.● Una vez que la factura NFe se ha procesado correctamente en Ariba Network, los proveedores pueden

enviar el ID fiscal en el dominio para elemento de credencial cXML.

Cómo Ariba Network utiliza el ID fiscal para identificar a compradores

Ariba Network identifica compradores utilizando el dominio TaxID.

Cuando un proveedor envía una factura NFe, Ariba Network verifica que el ID fiscal del comprador está configurado en Ariba Network. Si el ID fiscal existe, Ariba Network también verifica que el comprador tenga una relación comercial activa con el proveedor utilizando la información que aparece en la factura NFe.

Ariba Network crea un nuevo proveedor privado si el proveedor no existe en Ariba Network. Los compradores pueden invitar al proveedor (suministrador) iniciando la activación de proveedores para el suministrador en Ariba Network.

NotaLos compradores deben verificar la dirección de correo electrónico del proveedor antes de iniciar la activación de proveedores para ellos. Para obtener más información sobre la activación de proveedores, consulte Enabling suppliers on Ariba Network.

Cómo pueden los proveedores aceptar la propiedad de cuentas

Los proveedores pueden utilizar la carta de invitación para invitación comercial para iniciar sesión en Ariba Network y registrarse como un nuevo proveedor o utilizar una cuenta existente en Ariba Network.

La activación rápida mediante ID fiscal no está sujeta a las cuotas de proveedor. Para obtener más información sobre los umbrales de cuotas de proveedor, consulte la página de suscripciones y precios .

Encontrará más información sobre facturas procedentes de proveedores brasileños en la Ariba Network guide to invoicing.

72PUBLICPÚBLICO

Guía de soluciones cXMLDireccionamiento y seguridad de documentos

Page 73: 355a de soluciones cXML - help.sap.com

Transacción Perfil

Cada servidor cXML debe aceptar la transacción Perfil. Esta transacción permite a los clientes cXML buscar qué servidores de solicitudes cXML admiten y sus URL. Permite a las aplicaciones obtener las URL de transacción más recientes de forma automática sin necesidad de intervención manual.

Uso de la transacción de perfil [página 73]

Documento ProfileRequest [página 75]

Documento ProfileResponse [página 77]

Consejos de implementación y restricciones para ProfileResponse [página 77]

Uso de la transacción de perfilAriba Network, los proveedores y los proveedores de servicios envían y reciben documentos ProfileRequest. Las organizaciones compradoras envían documentos ProfileRequest, y los reciben si utilizan el sitio PunchIn de Ariba Collaboration o SAP Ariba Sourcing.

Envío de documentos ProfileRequest [página 73]

Recepción de documentos ProfileRequest [página 74]

Elemento de credencial From [página 74]

Frecuencia de consultas [página 75]

Envío de documentos ProfileRequest

Todas las aplicaciones cXML obtienen URL de Ariba Network enviando un documento ProfileRequest a una URL predeterminada.

Para buscar URL de Ariba Network, publique un documento ProfileRequest en la URL para las transacciones cXML. Ariba Network tiene un conjunto diferente de URL para documentos cXML autentificados mediante clave compartida y mediante certificado. Por ejemplo:

Centro de datos

Método de autentifica­ción URL de Ariba Network existente URL de Ariba Network solo de integración

EE. UU. clave compar­tida

https://service.ariba.com/service/transaction/cxml.asp

https://service-2.ariba.com/service/transac­tion/cxml.asp

Certificado https://certservice.ariba.com/service/transac­tion/cxml.asp

https://certservice-2.ariba.com/service/tran­saction/cxml.asp

Guía de soluciones cXMLTransacción Perfil

PUBLICPÚBLICO 73

Page 74: 355a de soluciones cXML - help.sap.com

NotaSAP Ariba recomienda utilizar TLS 1.2 o TLS 1.3 y las URL de Ariba Network solo de integración para el tráfico de cXML. La dirección URL de Ariba Network existente se utiliza como la dirección URL del navegador para aplicaciones de SAP Ariba.

Todos los socios comerciales pueden tener un conjunto diferente de URL en Ariba Network. Para cada uno de sus socios comerciales, envíe un documento ProfileRequest a Ariba Network para obtener URL de Ariba Network esta organización. Almacene en caché estas URL durante un máximo de 24 horas y utilícelas para todas las comunicaciones con el socio comercial. Puede reducir los gastos generales de comunicación consultando las URL de un socio comercial sólo si tiene documentos para enviar a esta organización.

Para obtener las URL de Ariba Network, utilice el ID de Ariba Network (NetworkID: AN01000000001) en la credencial To del documento ProfileRequest. Para obtener URL de un socio comercial en Ariba Network, utilice el ID del interlocutor en la credencial To del documento ProfileRequest.

Recepción de documentos ProfileRequestAriba Network pide a las aplicaciones cXML que busquen las transacciones que admiten y sus URL.

En la tabla siguiente se enumera dónde Ariba Network envía documentos ProfileRequest para cada tipo de aplicación:

Aplicación Ariba Network pide a su perfil cXML…

Sitios cXML de proveedor Publicar documentos ProfileRequest en sitios habilitados para cXML de proveedores (como por ejemplo sitios PunchOut) utilizando la URL que los proveedores indican en el campo URL de perfil en sus cuentas de Ariba Network.

Ariba Buyer 8.0 y anterior No admitido

Ariba Buyer 8.1 y posterior Publicar documentos ProfileRequest al sitio PunchIn de Ariba Collaboration con la URL que las organizaciones compradoras indican en el campo URL de perfil en sus cuentas de Ariba Net­work.

SAP Ariba Sourcing Publicar documentos ProfileRequest a SAP Ariba Sourcing con la URL que las organizaciones de Sourcing indican en el campo URL de perfil en sus cuentas de Ariba Network.

NotaSi el campo URL de perfil de su cuenta está vacío, Ariba Network enruta los documentos cXML a uno de los siguientes destinos, en este orden:

● Un destino de extremo configurado para su cuenta● Para pedidos: un método de enrutamiento cXML configurado para su cuenta

Elemento de credencial FromEn los documentos ProfileRequest enviados por Ariba Network, la credencial From identifica el socio comercial de inicio.

74PUBLICPÚBLICO

Guía de soluciones cXMLTransacción Perfil

Page 75: 355a de soluciones cXML - help.sap.com

Los servidores cXML (como por ejemplo los sitios PunchOut de proveedor) no deben utilizar nunca esta credencial From para decidir qué servicios y URL proporcionar. Ariba Network sólo almacena en caché un perfil por servidor cXML, y lo utiliza para todas las solicitudes del servidor, independientemente de la organización que las solicite. Por ejemplo, Ariba Network sólo almacena un perfil por sitio PunchOut, no un perfil para cada organización compradora que lo utilice.

Frecuencia de consultas

Ariba Network consulta a las aplicaciones cXML sus perfiles cuando los usuarios solicitan servicios de estos sitios. Ariba Network almacena en caché perfiles hasta 24 horas. Las aplicaciones cXML deben consultar en Ariba Network su perfil una vez cada 24 horas.

Por ejemplo, cuando Ariba Buyer inicia una sesión PunchOut, Ariba Network consulta inmediatamente en el sitio PunchOut del proveedor su perfil y Ariba Network utiliza esta información del perfil para todas las transacciones subsiguientes que inicia en el sitio durante las siguientes 24 horas.

Todas las cuentas de Ariba Network tienen un botón Restablecer perfil que borra el perfil cXML de la organización almacenado en caché en Ariba Network. La próxima vez que Ariba Network necesite enviar a la organización un documento cXML, consulta en el sitio su perfil cXML en lugar de utilizar el perfil almacenado en caché, que puede tener hasta 24 horas de antigüedad. Esta función es útil al integrar aplicaciones con Ariba Network.

Documento ProfileRequestLas URL de transacción de aplicación cXML pueden cambiar periódicamente debido a requisitos de configuración interna, fiabilidad y ajuste de carga. Utilice la transacción de perfil para buscar las URL de Ariba Network y de los socios comerciales actuales.

La aplicación publica un documento ProfileRequest en Ariba Network con la credencial To establecida en el ID de Ariba Network (NetworkID: AN01000000001), y Ariba Network responde con un documento ProfileResponse que enumera todas las transacciones cXML que admite y las URL de dichas transacciones. Para cada uno de sus socios comerciales, la aplicación también publica un documento ProfileRequest en Ariba Network con la credencial To establecida en el ID del socio comercial y Ariba Network responde con un documento ProfileResponse que enumera todas las transacciones cXML que el socio admite y las URL de dichas transacciones.

La lista siguiente muestra un ejemplo de ProfileRequest enviada a Ariba Network para obtener las URL de Ariba Network. Es una Request simple que contiene un elemento ProfileRequest vacío.

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cXML.org/schemas/cXML/1.2.014/cXML.dtd"><cXML payloadID="[email protected]" xml:lang="en-US" timestamp="2001-03-12T18:39:09-08:00"><Header> <From> <Credential domain="NetworkID"> <Identity>AN0100000123</Identity> </Credential> </From> <To>

Guía de soluciones cXMLTransacción Perfil

PUBLICPÚBLICO 75

Page 76: 355a de soluciones cXML - help.sap.com

<Credential domain="NetworkID"> <Identity>AN01000000001</Identity> </Credential> </To> <Sender> <Credential domain="NetworkID"> <Identity>AN0100000123</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Our Download Application, v1.0</UserAgent> </Sender></Header><Request> <ProfileRequest></ProfileRequest> </Request> </cXML>

Utilice su ID en las credenciales From y Sender y el ID de Ariba Network en la credencial To. El NetworkID AN01000000001 siempre representa Ariba Network.

Si su cliente utiliza diferentes aplicaciones de compras para sus organizaciones de negocios, especifique el ID de la aplicación del sistema de compras en la credencial To. Este ID ayuda a Ariba Network a identificar la aplicación de compras con la dirección Facturar a asociada.

En el listado siguiente se muestra una ProfileRequest de ejemplo que contiene el ID de sistema. Es una Request simple que contiene un elemento ProfileRequest vacío.

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://svcdev.ariba.com/schemas/cXML/1.2.017/cXML.dtd"><cXML payloadID="[email protected]" timestamp="2007-09-12T04:52:36-07:00" > <Header> <From> <Credential domain="NetworkID"> <Identity>AN01000000123</Identity> </Credential> </From> <To> <Credential domain="NetworkID"> <Identity>AN01000000001</Identity> </Credential> <Credential domain="SystemID"> <Identity>SAP001</Identity> </Credential> </To> <Sender> <Credential domain="NetworkID"> <Identity>AN01000000123</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Supplier</UserAgent> </Sender> </Header> <Request> <ProfileRequest /> </Request> </cXML>

76PUBLICPÚBLICO

Guía de soluciones cXMLTransacción Perfil

Page 77: 355a de soluciones cXML - help.sap.com

Documento ProfileResponseAriba Network devuelve un documento ProfileResponse como respuesta a ProfileRequest.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cXML.org/schemas/cXML/1.2.014/cXML.dtd"><cXML payloadID="[email protected]" xml:lang="en-US" timestamp="2001-03-12T18:39:10-08:00"> <Response> <Status code="200" text="OK"/> <ProfileResponse effectiveDate="2001-03-12T18:39:10-08:00"> <Transaction requestName="ConfirmationRequest"> <URL>https://service.ariba.com/service/transaction/cxml.asp</URL> </Transaction> <Transaction requestName="PunchOutSetupRequest"> <URL>https://service.ariba.com/service/transaction/cxml.asp</URL> </Transaction> <Transaction requestName="InvoiceDetailRequest"> <URL>https://svcorms.ariba.com/service/transaction/cxml.asp</URL> </Transaction> . . . </ProfileResponse> </Response> </cXML>

En este ejemplo sólo se enumeran tres transacciones (ConfirmationRequest, PunchOutSetupRequest y InvoiceDetailRequest); la ProfileResponse real enumera muchas más transacciones. Su aplicación almacena en caché esta información y utiliza las URL para todas las comunicaciones con Ariba Network o el socio comercial para las siguientes 24 horas.

Los posibles códigos de estado en la respuesta son:

● 200: Correcto● 4xx: Error irrecuperable● 5xx: Error temporal El cliente debe reintentar esta solicitud

Consejos de implementación y restricciones para ProfileResponsePara una creación correcta de documentos ProfileResponse, utilice URL HTTPS, seleccione las opciones correctas para OrderRequest y pruebe su implementación antes del despliegue.

URL HTTPS [página 78]

Opciones para OrderRequest [página 78]

Guía de soluciones cXMLTransacción Perfil

PUBLICPÚBLICO 77

Page 78: 355a de soluciones cXML - help.sap.com

URL de prueba de Ariba Network [página 78]

URL HTTPS

Ariba Network requiere que sus documentos ProfileResponse devuelvan URL con prefijos "https://".

Para obtener más información acerca de HTTPS, consulte Conexiones HTTPS [página 36].

Opciones para OrderRequest

La especificación cXML proporciona opciones attachments y changes para OrderRequest en documentosProfileResponse.

<Option name="attachments">Yes</Option> <Option name="changes">Yes</Option>

La ProfileRequest generada por Ariba Network no contiene estas opciones, aunque Ariba Network acepta pedidos adjuntos y pedidos de cambio.

De manera similar, Ariba Network no interpreta estas opciones si aparecen en documentos ProfileRequest de proveedores.

URL de prueba de Ariba Network

Ariba Network tiene tres URL de prueba que puede utilizar para ejercitar el tratamiento de errores permanentes (4xx) y errores temporales (5xx) de aplicación cXML. Utilice estas URL como casos de prueba negativos.

● https://service.ariba.com/ANCXMLDispatcher.aw/ad/cxml400Test%E2%80%A8; Esta URL devuelve un estado 4xx aleatorio, independientemente de su documento cXML. Utilice esta URL para probar el tratamiento de errores permanentes de su aplicación cXML.

● https://service.ariba.com/ANCXMLDispatcher.aw/ad/cxml500Test%E2%80%A8 Esta URL devuelve un estado 5xx aleatorio, independientemente de su documento cXML. Utilice esta URL para probar el tratamiento de errores temporales de su aplicación cXML.

● https://service.ariba.com/ANCXMLDispatcher.aw/ad/cxmlUniqueTest%E2%80%A8 Esta URL devuelve un estado 200 la mitad del tiempo y un estado 5xx la otra mitad. Utilice esta URL para probar la capacidad de reintentos de su aplicación cXML.

78PUBLICPÚBLICO

Guía de soluciones cXMLTransacción Perfil

Page 79: 355a de soluciones cXML - help.sap.com

Planificación de sitios PunchOut

PunchOut le permite ofrecer productos y servicios con la determinación de precios en vivo y la personalización específica de la empresa. PunchOut ofrece una experiencia de compra web que los catálogos estáticos no pueden ofrecer, pero requiere un mayor esfuerzo de desarrollo.

Siguiendo la metodología que se sugiere aquí, puede planificar y promocionar una solución para un cliente que pueda aplicarse fácilmente a más clientes adicionales.

PunchOut frente a catálogos estáticos [página 79]

Metodología de implementación del sitio PunchOut [página 80]

Planificación de un sitio PunchOut [página 80]

Diseño del sitio PunchOut [página 83]

Desarrollo del sitio PunchOut [página 86]

Prueba del sitio PunchOut [página 88]

Despliegue del sitio PunchOut [página 90]

Adecuación de un sitio Web existente [página 91]

PunchOut para servicios [página 92]

Cómo escribir una guía de despliegue PunchOut [página 93]

PunchOut frente a catálogos estáticos

Ariba Buyer muestra artículos de catálogo PunchOut y estáticos en la jerarquía de catálogo local, lo que permite a los usuarios seleccionar artículos e insertarlos en solicitudes de compra. El contenido del catálogo estático reside completamente en Ariba Buyer, y su sitio web aloja el contenido del catálogo de PunchOut.

Jerarquía de catálogo y artículos en línea de solicitud de compra

Mientras que los catálogos estáticos rellenan tanto la jerarquía de catálogo como los artículos en línea de la solicitud de compra, PunchOut utiliza vehículos separados para rellenar la jerarquía de catálogo como los artículos en línea de la solicitud de compra.

En primer lugar, PunchOut requiere que proporcione un catálogo de índice PunchOut para que el cliente lo cargue en Ariba Buyer. En segundo lugar, el sitio PunchOut envía mensajes cXML a Ariba Buyer para rellenar las solicitudes de compra con artículos en línea.

Guía de soluciones cXMLPlanificación de sitios PunchOut

PUBLICPÚBLICO 79

Page 80: 355a de soluciones cXML - help.sap.com

Decidir si utilizar PunchOut

El desarrollo de un sitio PunchOut puede ser muy costoso y llevar mucho tiempo. Considere si sólo vende una pequeña cantidad de productos si un catálogo estático puede ser más apropiado que un sitio PunchOut.

Considere también si sus clientes utilizarán PunchOut. Los clientes pueden configurar Ariba Buyer para permitir o no PunchOut. Consulte con sus clientes para ver si lo permitirán.

Metodología de implementación del sitio PunchOut

La implementación de un sitio PunchOut abarca desde la evaluación inicial de su sistema eCommerce existente hasta el desarrollo y el despliegue. Cuanto más esfuerzo invierta en las etapas iniciales de la implementación, más posibilidades tiene de poder desplegar su sitio PunchOut a tiempo con la funcionalidad deseada.

Los pasos para crear un sitio PunchOut son:

● Planificación de un sitio PunchOut [página 80]● Diseño del sitio PunchOut [página 83]● Desarrollo del sitio PunchOut [página 86]● Prueba del sitio PunchOut [página 88]● Despliegue del sitio PunchOut [página 90]

Planificación de un sitio PunchOut

En la fase de planificación, crea una visión de alto nivel de la integración entre Ariba Buyer, Ariba Network, el sitio PunchOut y el sistema de procesamiento de pedidos. En este paso, desarrolla una estimación del plan de proyecto y de los recursos necesarios.

Análisis de estados actuales y futuros [página 80]

Externalización frente a desarrollo de sitio PunchOut interno [página 81]

Participantes clave para integración PunchOut [página 82]

Soporte necesario para determinar el nivel del sitio PunchOut [página 83]

Análisis de estados actuales y futuros

Antes de desarrollar un sitio de PunchOut, lleve a cabo un análisis detallado de sus sistemas de eCommerce actuales y procesamiento de pedidos para buscar cómo debe modificarlos.

80PUBLICPÚBLICO

Guía de soluciones cXMLPlanificación de sitios PunchOut

Page 81: 355a de soluciones cXML - help.sap.com

Evaluación de su sitio actual

Evalúe su sitio actual para eCommerce, integración XML, procesamiento de pedidos electrónicos, conexión con su sistema de contabilidad, integración con los datos de control del cliente y capacidad para suministrar determinación de precios personalizada.

● ¿Tiene un sitio eCommerce existente?● ¿Tiene su sitio la integración XML habilitada?● ¿Recibe actualmente pedidos electrónicamente mediante XML o EDI?● ¿Cómo se lleva a cabo la integración con sus sistemas de contabilidad?● ¿Utiliza los datos de control de sus clientes (por ejemplo, ID de ubicación de expedición) para identificar la

determinación de precios y la expedición de pedidos?● Actualmente, ¿su sitio tiene la capacidad de suministrar determinación de precios personalizada o contenido

basado en el ID de cliente?

Plan para el sitio PunchOut

Evalúe el flujo del proceso desde la compra hasta la colocación y el cumplimiento del pedido, la cantidad de personalización que desea proporcionar por empresa y cómo modelará un "carrito de la compra", entre otras consideraciones.

● ¿Cuál es el flujo del proceso desde la compra hasta la colocación y el cumplimiento del pedido?● ¿Cuánta personalización por empresa desea proporcionar?● ¿Puede seleccionarse una línea de productos para un piloto inicial del sitio PunchOut?● ¿Necesitará una interfaz con varias aplicaciones de compras basadas en XML?● ¿Cómo modelará un "carrito de la compra" en artículos en línea de solicitud?

Externalización frente a desarrollo de sitio PunchOut interno

Revise sus recursos disponibles para implementar sus sitios PunchOut. La generación de un sitio PunchOut requiere experiencia en programación, que puede desarrollar en su organización o servicio externo.

Algunos factores clave que se deben tener en cuenta son:

● ¿Su personal técnico puede implementar un sitio PunchOut?● ¿Dispone de una infraestructura web existente que se pueda aprovechar para utilizar cXML?● ¿Tiene un presupuesto aprobado para iniciativas eCommerce, en particular, activación PunchOut?● ¿Ha evaluado el flujo de proceso con PunchOut para verificar que se adapta con su modelo de negocio?

PunchOut se puede utilizar tanto para productos como para servicios.

Guía de soluciones cXMLPlanificación de sitios PunchOut

PUBLICPÚBLICO 81

Page 82: 355a de soluciones cXML - help.sap.com

Participantes clave para integración PunchOut

El proceso de integración de SAP Ariba es un esfuerzo colaborativo que aprovecha sus recursos internos y externos. Hay tres posibles participantes clave: el desarrollador técnico, el administrador de integración y los servicios de proveedor de SAP Ariba.

Desarrollador técnico

Identifica un miembro del equipo que será el desarrollador técnico del sitio PunchOut. Esta persona actúa como el propietario primario del proceso de PunchOut y asume la responsabilidad de una serie de tareas.

La siguiente es una descripción de la función del desarrollador técnico:

● Lee la documentación PunchOut disponible de los siguientes sitios Web:http://supplier.ariba.comwww.cXML.org

● Se familiariza con la metodología de Ariba Network, desarrolla o posee grandes conocimientos sobre formatos de catálogos incluyendo:○ CIF (Catalog Interchange Format)○ cXML○ PunchOut

● Prueba el sitio PunchOut con Ariba Network y con clientes● Administra la cuenta de proveedor de Ariba Network para todos los asuntos relacionados con PunchOut● Realiza un mantenimiento constante del sitio PunchOut

Administrador de integración

Identifica un miembro del equipo que será el administrador de integración del sitio PunchOut. Esta persona es el punto de contacto para asuntos empresariales, no técnicos, relacionados con el PunchOut.

La siguiente es una descripción de la función del administrador de integración del proveedor:

● Verifica el ANID (ID de Ariba Network) o el número Dun & Bradstreet D-U-N-S (Data Universal Numbering System) para su empresa

● Administra las relaciones PunchOut con clientes, resolviendo asuntos como:○ Identificación de mercancías específicas para PunchOut○ Entrega de códigos de mercancía para productos PunchOut al cliente○ Definición de procesos de pedidos de compra y facturas con el cliente

● Crea un plan de proyecto y un calendario de implementación● Define requisitos de recursos adicionales y efectúa asignaciones apropiadas

Servicios de proveedor de SAP Ariba

SAP Ariba proporciona asistencia específica con tareas concretas tales como registro de Ariba Network, creación de catálogos, desarrollo del sitio PunchOut y prueba de integración. SAP Ariba es compatible con cualquier nivel de experiencia técnica.

82PUBLICPÚBLICO

Guía de soluciones cXMLPlanificación de sitios PunchOut

Page 83: 355a de soluciones cXML - help.sap.com

Soporte necesario para determinar el nivel del sitio PunchOutSus requisitos de negocios, el volumen del pedido, el importe de automatización deseado y la experiencia del equipo determinan el nivel de soporte que necesita.

Responder a las siguientes preguntas puede ser útil para determinar lo que necesita.

● ¿Tiene su equipo un conocimiento sólido de XML y cXML?XML proporciona los módulos de todos los documentos cXML. Los documentos cXML proporcionan una forma para que los compradores, los proveedores y Ariba Network se comuniquen entre ellos a través de Internet. Los documentos cXML están formados en base a archivos Document Type Definition (DTD), que se utilizan para definir un modelo de contenido para un documento cXML. Los DTD incluyen las especificaciones para los elementos permitidos, los tipos de datos de atributos y su pedido.

● ¿Dispone actualmente de algunas aplicaciones de eCommerce basadas en web, habilitadas para XML y transactivas?Los desarrolladores técnicos deben tener una comprensión fundamental de cómo crear, recibir, transmitir, analizar y consultar datos XML a y desde un origen remoto. Un analizador XML es la herramienta básica que utilizan los desarrolladores para procesar mensajes XML. Hay herramientas gratuitas disponibles para que el equipo técnico se familiarice con XML y cXML.

● ¿Tiene actualmente un archivo de índice de catálogo?Un archivo de índice de catálogo es un documento cXML o CIF que ha creado y que el cliente carga en Ariba Buyer para crear entradas en la jerarquía de catálogo. El archivo define de qué manera usted y sus productos aparecen en la interfaz de usuario del catálogo de Ariba Buyer. La entrada de catálogo para artículos PunchOut es similar a los artículos estáticos, excepto que contiene un enlace URL al que se puede hacer clic en el sitio PunchOut en lugar de un precio por unidad. Cuando los usuarios seleccionan un artículo PunchOut, Ariba Buyer forma y envía un documento cXML PunchOutSetupRequest a Ariba Network, que inicia la sesión PunchOut.

Diseño del sitio PunchOutDurante la fase de diseño, analiza el diseño general de su sitio PunchOut y decide cómo integrarlo con su sistema de procesamiento de pedidos.

Los formatos de catálogo PunchOut, CIF o cXML pueden ser mejores para algunas mercancías y reglas de negocio de clientes, por lo que debe debatir su uso con sus clientes para comprender sus requisitos. Debe analizar las áreas siguientes:

Requisitos del sitio PunchOut de proveedor [página 83]

Requisitos del sitio PunchOut de cliente [página 84]

Más información acerca de cXML y PunchOut [página 85]

Requisitos del sitio PunchOut de proveedorEl protocolo PunchOut es lo suficientemente flexible para que pueda diferenciar su sitio PunchOut de los sitios de los otros proveedores. Varios factores, como la programación, el presupuesto y el aspecto deseado influenciarán

Guía de soluciones cXMLPlanificación de sitios PunchOut

PUBLICPÚBLICO 83

Page 84: 355a de soluciones cXML - help.sap.com

en cómo enfoca estos requisitos específicos de proveedor y debe revisarlos todos como parte de su diseño de proceso.

Personalización

La personalización es el proceso que utiliza para que su sitio PunchOut sea único. Puede personalizar el aspecto y la funcionalidad del sitio según la autentificación del cliente.

Le animamos a personalizar su sitio PunchOut y a aprovechar el aspecto de sus sitios web existentes. Sin embargo, los sitios PunchOut no requieren funciones típicas de sitio eCommerce, como campos de entrada para el inicio de sesión manual, enlaces para salir de la sesión de compra actual o acceso a sitios externos.

Publicación del catálogo de índice

Los catálogos de índice PunchOut se publican en Ariba Network como los otros tipos de catálogo. Puede hacer que el catálogo sea público (disponible para todos los clientes) o privado (sólo disponible para clientes específicos).

Los clientes seleccionan catálogos según su descripción y los detalles del proveedor. La publicación de un catálogo de índice PunchOut en Ariba Network es la forma más rápida de hacer saber a los clientes que tiene un sitio PunchOut disponible.

Requisitos del sitio PunchOut de cliente

Reúnase con sus clientes para determinar sus requisitos técnicos y empresariales. Idealmente, recopila esta información de cada cliente que desee usar su sitio PunchOut.

Requisitos empresariales

Hable con sus clientes acerca de qué productos deben estar disponibles en el sitio PunchOut. Para una mejor experiencia de usuario, debe comprender los requisitos empresariales de alto nivel de sus clientes.

● Analice las prácticas de compra actuales y futuras de sus clientes.● Determine los requisitos específicos del contenido de sus clientes por mercancía.● Identifique cualquier consideración o requisito de informe.● Asigne propiedad a todo su equipo para resolver problemas pendientes.

84PUBLICPÚBLICO

Guía de soluciones cXMLPlanificación de sitios PunchOut

Page 85: 355a de soluciones cXML - help.sap.com

Requisitos técnicos

Busque los requisitos técnicos de sus clientes para las transacciones y el contenido de producto. Desarrolle los procesos para abordar los problemas que surgen cuando dos organizaciones mantienen una relación comercial.

Algunos de los problemas que se deben comentar son:

● Contenido y determinación de precios, incluyendo contratos regionales frente a nacionales● Codificación de unidad de medida (UM) y códigos de mercancías● Problemas internacionales, como la diversidad de idiomas y divisas● Transporte, métodos de expedición e impuestos● Cómo iniciar el pago, como tarjeta de compra o factura● Emisión de créditos y devoluciones● Pedidos de compra por encargo● Pedidos cambiados y cancelados● Información adicional necesaria para documentos y solicitudes cXML, como por ejemplo centro de costes,

departamento, solicitante y código de cuenta de proveedor● Cómo tratar conflictos con canales de ventas existentes, como distribuidores● Actualización del estado del pedido en Ariba Network

Seguridad

Su sitio PunchOut debe comunicar a través de HTTPS (Hyper Text Transfer Protocol Secure). HTTPS protege todas las partes de las sesiones PunchOut: su cliente, Ariba Network y el sitio PunchOut.

Para obtener más información, consulte Conexiones HTTPS [página 36].

Más información acerca de cXML y PunchOut

Es preciso que documente el flujo del proceso de transacción dentro y fuera de su sitio Web y que identifique qué mensajes se han de codificar. SAP Ariba dispone de documentación para ayudarle en la definición del proceso.

El desarrollador técnico debería leer las siguientes guías, disponibles en Ariba Network.

Guía Describe

Configuración del enrutamiento de documento Cómo instalar una configuración avanzada, incluyendo la configuración cXML

Creación y gestión de catálogos Cómo cargar, probar y publicar catálogos estáticos y de PunchOut

Referencia sobre formato de catálogo Funciones de catálogo y la sintaxis de catálogos CIF y cXML

Guía de soluciones cXMLPlanificación de sitios PunchOut

PUBLICPÚBLICO 85

Page 86: 355a de soluciones cXML - help.sap.com

Desarrollo del sitio PunchOut

El desarrollo implica la implementación de cada paso en el proceso PunchOut. Este proceso se puede describir mediante el flujo de mensajes.

Flujo de mensajes PunchOut

Una sesión PunchOut consta de varios mensajes cXML que pasan entre Ariba Buyer, Ariba Network y su sitio PunchOut.

Los mensajes cXML para una sesión PunchOut incluyen:

1. Inicio de sesión de usuarioUn usuario de una organización compradora primero inicia sesión en Ariba Buyer y crea una solicitud de compra. Este paso es importante, porque significa que el usuario ha sido autentificado por la organización compradora. Durante el PunchOut, Ariba Network autentifica a la organización compradora, no al usuario.

2. Selección de sitios PunchOutA continuación, el usuario busca productos y servicios en la aplicación de compras y selecciona el artículo PunchOut. Según lo que se incluya en el catálogo de índice de PunchOut, el PunchOut es a nivel de experiencia de usuario en tienda, de pasillo, de estantería o de producto. Si ofrece PunchOut a nivel de pasillo, estantería o producto, el usuario realiza un punch-out a una página en su sitio que describe el pasillo, la estantería o el producto. Si ofrece un PunchOut a nivel de tienda, el usuario realiza un punch-out para ver todos los productos seleccionando el nombre de la empresa. El PunchOut a nivel de tienda normalmente requiere que su sitio tenga un mecanismo de búsqueda para que los usuarios puedan buscar los artículos que necesitan.

3. PunchOutSetupRequestAriba Buyer genera un documento PunchOutSetupRequest cXML y lo envía mediante HTTP Post a Ariba Network. Ariba Network lo autentifica y lo reenvía mediante HTTP Post al sitio PunchOut.Cuando la organización compradora se registra en Ariba Network, configura un SharedSecret. Los documentos PunchOutSetupRequest enviados a Ariba Network identifican el cliente según el elemento Identity en el elemento From y rellenan el Credential domain con el NetworkID del cliente. Cada organización compradora tiene su propio NetworkID.Cuando Ariba Network determina de quién es la solicitud y para quién es, elimina la clave compartida del cliente y utiliza la de su cuenta de Ariba Network. Esta clave compartida permite que PunchOutSetupRequest inicie sesión sin problemas en su sitio PunchOut. Nunca puede ver la SharedSecret de su cliente y no debe mantener ninguna contraseña/inicio de sesión separada para cada usuario o cliente. El usuario final se puede identificar en los elementos Contact y Extrinsic.Además de los parámetros de autentificación y de identificación, el documento PunchOutSetupRequest contiene una BuyerCookie. La BuyerCookie cambia entre sesiones PunchOut periódicas, lo que le permite llevar un seguimiento de en qué pantalla en concreto está el usuario durante el proceso de compra. Una operación de edición en un pedido existente normalmente resulta en una nueva cookie de comprador para esta sesión en concreto. Para ser más específicos, Ariba Buyer garantiza que la cookie de usuario sea única entre todos los valores utilizados por las sesiones PunchOut iniciadas simultáneamente. El valor puede, por ejemplo, corresponder a un identificador de sesión en esta aplicación. Para enlazar un pedido específico con un usuario, utilice el elemento SupplierPartAuxiliaryID (cookie de proveedor).

4. Autentificación PunchOut

86PUBLICPÚBLICO

Guía de soluciones cXMLPlanificación de sitios PunchOut

Page 87: 355a de soluciones cXML - help.sap.com

Cuando su sitio PunchOut recibe el documento PunchOutSetupRequest, lleva a cabo las tareas siguientes:○ Autentifica Ariba Network según el Sender y la SharedSecret○ Verifica la identificación From

Ahora puede iniciar una sesión porque la organización compradora es un miembro certificado de Ariba Network. Su sitio PunchOut puede generar una página de compras para la sesión PunchOut.

5. PunchOutSetupResponseEl sitio PunchOut redirecciona al usuario. Envía un documento PunchOutSetupResponse a Ariba Network con su StartPage URL, que es la página de compras del sitio PunchOut. Ariba Network reenvía la PunchOutSetupResponse a Ariba Buyer.

6. ComprasAriba Buyer abre su sitio PunchOut en una ventana nueva con la StartPage URL que ha proporcionado. El usuario selecciona y configura productos o servicios. Al seleccionar un artículo se agrega a la cesta o al carrito de la compra del sitio.

7. PunchOutOrderMessageAl terminar de seleccionar los artículos en el sitio PunchOut, el usuario hace clic en el enlace Confirmar la compra. Su sitio envía un documento PunchOutOrderMessage a Ariba Buyer (en un campo de formulario oculto HTML) que enumera los contenidos del carrito de la compra del usuario.La ventana que muestra el sitio PunchOut desaparece y aparece la descripción de los artículos PunchOut en la solicitud de compra del usuario. Esta información actúa como una oferta, no un pedido real. Cuando se aprueba la oferta en Ariba Buyer, genera un pedido de compra.Para que el usuario no se confunda, el proceso de confirmar la compra debe usar la siguiente secuencia de botones:1. Agregar artículo al carrito2. Confirmar la compra

El proceso de confirmar la compra no debe requerir la introducción de información de la tarjeta de crédito o detalles de dirección Expedir a. Estos datos se actualizan en Ariba Buyer.En Ariba Buyer 6.1 y anterior, dado que el sitio aparece en una nueva ventana del navegador, hay una pantalla final que el usuario puede ver y que contiene el número de solicitud de compra y un botón Cerrar navegador. El usuario vuelve a Ariba Buyer mediante este botón.Para permitir a los usuarios volver al sitio PunchOut y para poder realizar modificaciones en el sitio, el documento PunchOutOrderMessage debe tener el atributo operationAllowed="edit".

8. Aprobación de solicitudAriba Buyer envía la solicitud de compra para su aprobación en la organización compradora. No se actualiza en el progreso de la solicitud de compra hasta que haya recibido todas las aprobaciones necesarias y se haya convertido en un pedido de compra.Si los administradores de la cadena de aprobación deniegan una solicitud de compra, pueden usar PunchOut para ir al sitio para eliminar artículos en línea o la solicitud de compra. Debe llegar a un acuerdo con los clientes acerca de cómo deben tratarse las solicitudes canceladas.

9. OrderRequestDespués de aprobar la solicitud de compra, Ariba Buyer genera un documento OrderRequest y se le transmite mediante Ariba Network. Este documento contiene los detalles del pedido de compra necesarios para el procesamiento.

Información relacionada

Pedidos de compra [página 142]

Guía de soluciones cXMLPlanificación de sitios PunchOut

PUBLICPÚBLICO 87

Page 88: 355a de soluciones cXML - help.sap.com

Extrínsecos y cookies de proveedorAriba Buyer utiliza datos extrínsecos para identificar a un usuario. Los extrínsecos estándar enviados desde Ariba Buyer en documentos PunchOutSetupRequest son User y CostCenter. Los clientes determinan el nombre y la población de todos los elementos extrínsecos, por lo que debe indicar todos los datos adicionales que necesite.

No se aconseja depender de los datos extrínsecos, porque dificulta aún más el uso del sitio PunchOut con otros clientes.

El elemento SupplierPartAuxiliaryID, o "cookie de proveedor", le permite transmitir datos adicionales, como por ejemplo un número de oferta de su sitio PunchOut al pedido de compra. Ariba Buyer se lo pasa de nuevo en cualquier sesión de "edición" o "inspección" subsiguiente PunchOutSetupRequest, y cualquier documento OrderRequest resultante. A menudo, los proveedores utilizan la cookie para asociar artículos en una solicitud de compra con los artículos correspondientes en un carrito de la compra de sesión PunchOut.

Prueba del sitio PunchOutLa fase de evaluación de PunchOut garantiza que el sitio esté configurado adecuadamente y que se comunica eficazmente con Ariba Buyer. El test implica dos pasos: test automático en Ariba Network y test posterior con los clientes.

NotaDebe asegurarse de que el uso de cookies de su sitio web de PunchOut y el seguimiento en línea sea conforme a la normativa general de protección de datos (GDPR) y la normativa de privacidad electrónica (ePR).

SAP Ariba recomienda utilizar las herramientas adecuadas para poner a prueba su sitio y asegurarse de que sean conformes a GDPR y ePR. Estas herramientas podrían indicarle que realice modificaciones como eliminar todas las referencias http externas y tener una política de cookies individual para los visitantes del sitio.

Autoevaluación del sitio PunchOut en Ariba Network [página 88]

Evaluación del sitio PunchOut con clientes [página 89]

Autoevaluación del sitio PunchOut en Ariba NetworkSu cuenta de Ariba Network tiene una cuenta paralela denominada cuenta de prueba. Las cuentas de prueba tienen un responsable de evaluación de catálogo integrado que le permite comprobar los catálogos estáticos, los sitios PunchOut y la ruta de los pedidos.

Utilícelo para evaluar su sitio PunchOut y para enviarse pedidos de compra simples a sí mismo. Tiene una función de un sólo paso, que le permite editar cada documento PunchOut antes de la transmisión.

NotaEl responsable de evaluación del catálogo es útil para depurar el sitio PunchOut y para hacer una demostración del sitio a los clientes potenciales. Para obtener información sobre el uso de la cuenta de prueba y el responsable de evaluación de catálogo, consulte Using test accounts on Ariba Network.

88PUBLICPÚBLICO

Guía de soluciones cXMLPlanificación de sitios PunchOut

Page 89: 355a de soluciones cXML - help.sap.com

Evaluación del sitio PunchOut con clientes

La fase final de la evaluación es ejercitar su sitio PunchOut con sus clientes.

Debe confirmar que sus clientes hayan activado las cuentas de prueba de Ariba Network y que hayan agregado su cuenta de prueba como un proveedor. A continuación, puede publicar su catálogo de índice para confirmar que cumple con sus criterios, permitirles que se ejerciten con su sitio PunchOut, recibir pedidos de prueba y puede observar estos pedidos en su sistema de entrada de pedidos.

Escenarios específicos que se deben ejecutar cuando la evaluación con los clientes incluye la autentificación y la evaluación básica de Ariba Buyer.

Autentificación

Su sitio PunchOut debe llevar a cabo la autentificación mediante el dominio, la identidad del comprador y la clave compartida. No puede desplegarlo si realiza la autentificación de cualquier otra manera, por ejemplo con un ID de usuario o con una contraseña introducida por el usuario.

Pruebas básicas de Ariba Buyer

Existe una cantidad de escenarios para probar su sitio PunchOut, incluyendo la prueba de artículos PunchOut, la simulación de una conexión perdida, la prueba de varios artículos en línea, compras por encargo, funcionalidad de artículos de servicio y determinación de precios de contrato,

● Prueba de artículo PunchOutCree una solicitud de compra en Ariba Buyer. Seleccione el artículo PunchOut de la jerarquía de catálogo.Comportamiento esperado: Ariba Buyer se conecta a su sitio PunchOut. El usuario puede comprar, colocar artículos en el carrito y devolver el carrito a la solicitud de compra de Ariba Buyer.

● Simulación una conexión perdidaCree una solicitud de compra en Ariba Buyer. Seleccione un artículo PunchOut. Ariba Buyer muestra su sitio PunchOut. Cierre el sitio PunchOut antes de "retirar la verificación".Comportamiento esperado: La sesión de usuario vuelve a Ariba Buyer y muestra la primera página de Ariba Buyer.Vuelva a seleccionar el artículo PunchOut.Comportamiento esperado: Vuelva al sitio PunchOut, dónde el carrito de la compra está vacío.

● Prueba de varios artículos en línea en una solicitud de compraCree una solicitud de compra con dos artículos en línea desde el mismo carrito de compra del sitio PunchOut. Después de que el carrito vuelva a la solicitud de compra, seleccione un artículo para iniciar la funcionalidad de edición.Comportamiento esperado: Los dos artículos aparecen en el carrito después de volver a su sitio PunchOut.Elimine los dos artículos del carrito del sitio PunchOut y vuelva a retirar la verificación.Comportamiento esperado: La solicitud de compra no debe contener ninguno de los artículos seleccionados durante la sesión PunchOut.

● Prueba de una compra por encargoDebe acordar con el cliente cómo tratar y dirigir compras por encargo (que no sean del catálogo). Cree una solicitud de compra con artículos por encargo y vea cómo aparece en su sistema de introducción de pedidos.

Guía de soluciones cXMLPlanificación de sitios PunchOut

PUBLICPÚBLICO 89

Page 90: 355a de soluciones cXML - help.sap.com

● Prueba de funcionalidad básica de artículos de servicioSi su sitio PunchOut enumera servicios, realice la prueba como un usuario:1. Vaya al sitio PunchOut y proporcione datos de configuración para comprar un servicio. El sitio PunchOut

devuelve un artículo en línea.2. Utilice una sesión de edición PunchOut para devolver un artículo en línea con determinación de precio.

Después de generar un pedido de compra, intente realizar un PunchOut con la edición y la inspección.● Prueba de determinación de precios de contrato

Si el ID de la organización compradora determina la determinación de precios, compruebe que se muestra el precio correcto.1. Vaya al sitio PunchOut y proporcione datos de configuración. Recibe un artículo en línea de vuelta con la

determinación de precios del contrato.2. Envíe la solicitud de compra e inicie el flujo de trabajo y el proceso de aprobación.3. Después de aprobar la solicitud de compra, utilice una sesión de PunchOut de edición para seleccionar el

producto. También puede utilizar una sesión PunchOut de inspección.

Despliegue del sitio PunchOutPara el despliegue, mueva el sitio probado a producción. Debe coordinar esta acción con sus clientes.

Gestión de configuración

Para que el proceso de estructuración y despliegue sea manejable y reproducible se aconseja que utilice un sistema de gestión de configuración. Puede dirigir el proceso de despliegue, incluida la creación de nuevos sitios web, desplazando archivos y generando contenido y determinaciones de precio específicas de cliente.

Servicio de atención al cliente

Confirme que su organización de servicio de atención al cliente está lista para admitir el nuevo sitio PunchOut y todos los nuevos procedimientos y directrices.

Verificación de plausibilidad

Inmediatamente después de la entrada en productivo, la organización compradora debe llevar a cabo unas evaluaciones de las sesiones PunchOut y crear varios pedidos de prueba para validar la conectividad en el entorno de producción. Finalmente, supervise su cuenta de Ariba Network para garantizar que la ruta de los pedidos de compra sea la correcta.

90PUBLICPÚBLICO

Guía de soluciones cXMLPlanificación de sitios PunchOut

Page 91: 355a de soluciones cXML - help.sap.com

Adecuación de un sitio Web existenteEs posible que tenga un sitio Web ya existente que desee cambiar para que soporte PunchOut. Por motivos empresariales o técnicos puede resultar útil utilizar un sitio de comercio electrónico ya existente.

Cómo aprovechar un sitio existente

Si el usuario interactúa con un sitio B2B típico, inicia sesión directamente, busca artículos, configura mercancías, selecciona opciones de expedición, introduce información de la tarjeta de crédito y coloca pedidos. Sin embargo, estos sitios realmente son aplicaciones B2C: Tratan a los usuarios como consumidores.

Pero los sitios B2B tienen un flujo de trabajo dinámico, aprobaciones, carritos de la compra guardados y determinación de precios de contrato. Su cliente debe calcular la información de expedición y de pago. Los procesos existentes, como el flujo de trabajo dinámico o la recopilación de información de pago y de expedición, no serán necesarios para PunchOut.

El modelo a adoptar al crear un sitio PunchOut es oferta y compra. Los usuarios llevan a cabo un PunchOut para la selección de productos, la configuración y la obtención de una oferta. Ariba Buyer genera el pedido de compra por separado. El flujo del proceso es el siguiente:

1. Un solicitante en Ariba Buyer utiliza PunchOut para ir a su sitio PunchOut y seleccionar productos.2. Al confirmar la compra, el sitio PunchOut devuelve los artículos totalmente configurados a Ariba Buyer.3. En Ariba Buyer, el usuario selecciona información logística, incluyendo facturar a, expedir a, el método de

expedición y la fecha para la que se requiere.4. El usuario envía la solicitud de compra para aprobación. Las partes de la organización compradora pueden

inspeccionar, editar, aprobar o denegar la solicitud de compra según la función de cada aprobador y sus permisos.

5. Cuando una solicitud de compra está totalmente aprobada, Ariba Buyer envía un pedido de compra con la expedición, la facturación y la fecha para la que se requiere.

Adecuación rápida

Puede llevar a cabo pasos para modificar un sitio de comercio electrónico para que admita PunchOut tan rápido como sea posible.

Procedimiento

1. Elimine todos los procesos no relacionados con la configuración.

Ariba Buyer autentifica a los usuarios y Ariba Network autentifica las organización compradoras.2. Adapte un modelo en el que proporciona una oferta y recibe un pedido de compra.

Guía de soluciones cXMLPlanificación de sitios PunchOut

PUBLICPÚBLICO 91

Page 92: 355a de soluciones cXML - help.sap.com

Si su sitio actual no admite el modelo de pedido de compra, aproveche la base de código existente y cree un sitio nuevo con procesos nuevos.

3. Elimine o desactive los pagos, las expediciones y el flujo de trabajo.

Ariba Buyer gestiona los pagos, las expediciones y el flujo de trabajo según los procesos empresariales concretos del cliente.

4. Depure la interfaz de usuario.

Elimine todos los enlaces a los sitios web externos. Los usuarios de PunchOut no deberían poder salir del sitio de PunchOut mientras naveguen por él.

PunchOut para serviciosSu sitio PunchOut puede ofrecer servicios temporales o permanentes. El desarrollo de un sitio PunchOut para servicios requiere una buena comprensión del proceso PunchOut y, posiblemente, la coordinación del aprovisionamiento de servicios con sus clientes.

El aprovisionamiento de servicios mediante Ariba Buyer es muy diferente del aprovisionamiento de mercancías. Para las mercancías, las listas del flujo de trabajo de aprobación y del control de acceso se encuentran en Ariba Buyer. No es necesaria ninguna configuración preliminar y las ofertas no cambian dinámicamente según las condiciones del mercado. Cualquier mercancía que no siga los principios anteriores tiende al PunchOut, dónde se actualiza el catálogo en su sitio.

Intercambio de servicios

Puede crear un sitio PunchOut que proporcione servicios o trabajo con contrato. Esto se denomina intercambio de servicios, porque los solicitantes solicitan servicios y configuran los ajustes descritos en el trabajo que necesitan.

Los usuarios siguen dos pasos para aprovisionar servicios de los intercambios de servicios:

1. Abrir una posición2. Contratar a un candidato para la posición abierta

Puede modelar estos pasos con dos operaciones PunchOut. El primer paso es una sesión de "creación" que rellena parcialmente un artículo en línea de solicitud. El segundo paso es una sesión de "edición" que agrega detalles adicionales para formar un artículo en línea completo. La sesión de creación abre una posición de trabajador con contrato; la sesión de edición contrata a un candidato para llenar la posición abierta.

Creación de sesión

La operación de PunchOut de creación de sesión define un empleado contratado. Esta sesión puede estar sujeta a un flujo de aprobación en Ariba Buyer si devuelve estimaciones de los servicios pedidos.

El sitio PunchOut puede detener temporalmente el flujo de trabajo mediante la retención de un campo clave, como por ejemplo Unidad de medida (UM). Puede enviar una notificación por correo electrónico al usuario para volver al

92PUBLICPÚBLICO

Guía de soluciones cXMLPlanificación de sitios PunchOut

Page 93: 355a de soluciones cXML - help.sap.com

sitio y continuar con el proceso. Estos mensajes no pueden desencadenar automáticamente un evento en Ariba Buyer.

Si la apertura de una posición requiere una aprobación previa en Ariba Buyer, debe organizar una cadena de aprobación doble personalizada para la mercancía específica de servicio. La organización compradora debe enviarle una notificación de aprobación o negación de una solicitud mediante notificaciones por correo electrónico.

Sesión de ediciónLa operación PunchOut de sesión de edición describe un servicio "creado" anteriormente. El usuario introduce datos faltantes (como por ejemplo la unidad de medida), lo que hace que la solicitud de compra sea completa y esté lista para el inicio del proceso de aprobación en Ariba Buyer.

Cuando el proceso de aprobación sea completo, Ariba Buyer envía el pedido de compra al intercambio de servicios. El trabajador contratado empieza la fecha de inicio negociada e introduce el tiempo que ha trabajado en los partes de horas. El sistema de contabilidad vinculado a Ariba Buyer procesa las facturas y las paga adecuadamente.

Cómo escribir una guía de despliegue PunchOutDespués de implementar un sitio PunchOut, SAP Ariba le recomienda que cree una "Guía de despliegue PunchOut", que explique sus directrices, capacidades y procesos, y que la proporcione a los implementadores de Ariba Buyer para que les ayude a integrarse con nuestro sitio y se adhiera a las directrices de negocio.

La "Guía de implementación PunchOut" debe contener las secciones siguientes:

Resumen de la conectividad de un sitio PunchOut [página 93]

Identificación y autentificación de un sitio PunchOut [página 94]

Extrínsecos requeridos del sitio PunchOut [página 94]

Especificación/Requisitos de contenido del sitio PunchOut [página 94]

Información de dirección del sitio PunchOut [página 94]

Estructura de contabilidad del sitio PunchOut [página 95]

Descripción del código de mercancía del sitio PunchOut [página 96]

Transacciones admitidas del sitio PunchOut [página 96]

Resumen de la conectividad de un sitio PunchOutDescribe el flujo del proceso PunchOut y la integración a Ariba Buyer. Puede copiar la explicación de la sección Secuencia de eventos PunchOut de la Guía de referencia de cXML.

Incluya los procesos concretos de la aplicación en la integración. Por ejemplo, solicitar presupuestos de documentos o servicios en los que es posible que sea necesario un segundo PunchOut para recibir el precio de los servicios seleccionados.

Guía de soluciones cXMLPlanificación de sitios PunchOut

PUBLICPÚBLICO 93

Page 94: 355a de soluciones cXML - help.sap.com

Identificación y autentificación de un sitio PunchOut

Explique cómo lleva a cabo la autentificación de las sesiones PunchOut.

Incluya cualquier información adicional utilizada para identificar al usuario, como por ejemplo extrínsecos PunchOutSetupRequest o elementos Contact o Address. Describa la capacidad del sitio PunchOut para utilizar esta información para presentar contenidos personalizados.

Extrínsecos requeridos del sitio PunchOut

Indique si su sitio requiere información extrínseca para iniciar sesiones PunchOut personalizadas. Mantenga el uso de los elementos extrínsecos al mínimo, porque aumentan el plazo de entrega de la implementación.

Las diferentes versiones de Ariba Buyer utilizan diferentes elementos extrínsecos predeterminados:

● Ariba Buyer 6.1 y anterior (cXML 1.0) utilizan elementos User y CostCenter. Sin embargo, los clientes pueden denominar estos extrínsecos de forma diferente, por lo que debe saber los nombres exactos.

● Ariba Buyer 7.0 y posterior (cXML 1.1) utilizan el elemento Contact, por lo que los elementos extrínsecos User y CostCenter quedan obsoletos.

En los pedidos de compra, los extrínsecos a menudo se utilizan para enviar información adicional desde el nivel del cliente hasta el nivel de artículo en línea, como sociedad y número de contrato. Describa cualquier extrínseco de artículo en línea que acepte.

Especificación/Requisitos de contenido del sitio PunchOut

Describa las capacidades y el proceso de especificación de contenidos. Describa el proceso para seleccionar las categorías de los productos que se muestran a los usuarios. Describa si tiene la capacidad de limitar el acceso a los artículos para ciertos usuarios de la organización.

Si visualiza artículos de contrato y que no forman parte del contrato, describa cómo se muestran y quién puede verlos. Por ejemplo, puede permitir a los usuarios que sólo vean artículos de contrato, pero puede permitir a los agentes de compras que vean todos los artículos. En este caso, describa cómo el sitio PunchOut determina las funciones de usuario.

Proporcione el catálogo de índice PunchOut (CIF o cXML) a los clientes para que los enlaces adecuados aparezcan en Ariba Buyer. Además, si admite el atributo SelectedItem (disponible en cXML 1.1), describa cómo lo utiliza.

Información de dirección del sitio PunchOut

Describa el formato de dirección de forma clara y con detalle para que Ariba Buyer pueda integrarlo con la aplicación de procesamiento de pedidos.

Algunos clientes utilizan el atributo addressID del elemento Address para identificar una dirección Expedir a o Facturar a predefinida. Si utiliza este atributo, describa el proceso de carga y actualización de los datos de

94PUBLICPÚBLICO

Guía de soluciones cXMLPlanificación de sitios PunchOut

Page 95: 355a de soluciones cXML - help.sap.com

dirección del cliente. Además, analice cómo trata las excepciones, como cuando el usuario arrastra la expedición de entrega a una ubicación que aún no se encuentre en Ariba Buyer, o cuando el usuario agrega una nueva dirección que usted aún no conoce. En el primer caso, el addressID es nulo; en el segundo caso, el addressID puede ser un número que no tenga.

Si no utiliza el atributo addressID, explique a los clientes qué deben enviarle en los elementos de dirección. Estos datos incluyen los elementos DeliverTo, que a menudo son los más problemáticos, porque algunos clientes los implementan diferente. En el caso más frecuente, contienen el nombre de una persona y el edificio, el piso o el punto de recogida. Normalmente, existen dos ocurrencias del elemento en el pedido, pero los clientes sólo envían una. Recopile la información que su cliente planea enviar antes de la implementación para que pueda asignarlas en el sistema.

De forma similar, también debe anotar el formato y el contenido de los elementos Street. Determine el formato de los datos que el cliente coloca en estos elementos antes de la implementación. El formato varía en un número de factores, incluyendo el sistema ERP utilizado. La tabla siguiente es útil para capturar esta información para el análisis.

Elemento # Cliente Proveedor

Descripción Longitud máxima Descripción Longitud máxima

DeliverTo 1

DeliverTo 2

Calle 1

Calle 2

Calle 3

Calle 4

Estructura de contabilidad del sitio PunchOut

Los clientes tienen diferentes formatos para la información de contabilidad que envían en los pedidos de compra y que reciben en las facturas. La diferencia se debe al número de factores, incluyendo el sistema ERP utilizando y en el diseño de la contabilidad general del cliente.

Recopile esta información durante la implementación y describa su habilidad para capturar y devolver esta información para la facturación y la reconciliación de tarjetas de compra. Puede utilizar la siguiente tabla para recopilar esta información de sus clientes:

Parámetro Datos de cliente ¿Devolver en fac­tura?

Tipo de segmento Formato/Longitud Descripción

Centro de informes Centro de costes Alpha/5 ID S

Cuenta de informe Cuenta Entero/6 Cuenta N

Negocio de informe Empresa Alpha/4 ID N

Guía de soluciones cXMLPlanificación de sitios PunchOut

PUBLICPÚBLICO 95

Page 96: 355a de soluciones cXML - help.sap.com

Descripción del código de mercancía del sitio PunchOut

Describa la norma del código de mercancía que admite para PunchOut y el nivel de granularidad de los datos que devuelve. Incluya un apéndice que enumere todos los códigos de mercancías que envía, para que los clientes puedan llevar a cabo cualquier asignación necesaria.

Pida a sus clientes que especifiquen los códigos de mercancías que utilizan para controlar el flujo de trabajo o las aprobaciones.

Se prefiere la norma UNSPSC (United Nations Standard Product and Service Code). Para obtener más información, consulte Códigos de mercancía [página 422].

Transacciones admitidas del sitio PunchOut

Describa las transacciones electrónicas que admite, el método que utiliza para procesar pedidos, cómo trata los pedidos que no se admiten electrónicamente y cómo procesa las excepciones.

Pedidos de cambio/cancelación

Ariba Network proporciona un método separado para dirigir los pedidos de cambio y de cancelación. Describa cómo orientar y procesar estos pedidos. Por ejemplo, debe orientar los pedidos de cambio/cancelación directamente a su departamento de expedición.

Para obtener más información, consulte Pedidos de cancelación y pedidos de cambio [página 182].

Artículos por encargo

Los pedidos por encargo que se le envía con un SupplierPartID de "No disponible" o con una marca isAdHoc. Describa si procesa estos artículos en línea.

Para obtener más información, consulte Artículos por encargo [página 190].

Pedidos que contienen artículos estáticos y de PunchOut

Si tiene catálogos estáticos y un catálogo de PunchOut, es probable que reciba pedidos de compra que contienen los dos tipos de artículos. El sistema que recibe los pedidos debe poder procesarlos.

Una diferencia entre estos dos tipos de artículos en línea es el contenido del elemento SupplierPartAuxiliaryID. Para los artículos en línea PunchOut, recibe el valor que genera su sitio PunchOut. Para pedidos de catálogo estáticos, recibe el valor del catálogo estático o ningún dato para los catálogos sin esta información.

96PUBLICPÚBLICO

Guía de soluciones cXMLPlanificación de sitios PunchOut

Page 97: 355a de soluciones cXML - help.sap.com

Solicitudes de compra copiadas

Ariba Buyer permite a los usuarios realizar copias de sus solicitudes de compra para repetir pedidos. Cuando copia solicitudes de compra, copia los contenidos de todos los artículos en línea, excepto el elemento SupplierPartAuxiliaryID.

Esta excepción preserva la integridad de su sitio PunchOut, porque controla el elemento. Dado que supplierPartID, quantity y price se encuentran en el artículo en línea copiado, debe poder procesarlo. Describa en esta sección si procesará pedidos de compra generados a partir de solicitudes de compra copiadas.

Cambios en el precio

Los precios pueden variar entre el momento en que tiene lugar la sesión PunchOut y el momento en que se envía el pedido de compra. Describa cómo procesa estas excepciones.

Proveedores de terceros

Si es un agregador de productos, su sitio PunchOut enumera los productos de otros proveedores, y orienta los pedidos de compra que recibe a estos proveedores. Use números D-U-N-S o NetworkIDs de proveedores de terceros para rellenar el elemento SupplierID en el nivel de artículo en línea.

Estos ID deben estar registrados en Ariba Network y en Ariba Buyer. Antes de enviar un pedido de compra a Ariba Network, Ariba Buyer determina para qué proveedor es la OrderRequest y rellena el elemento To en la cabecera con el número ANID o D-U-N-S del proveedor (que extrae del número D-U-N-S o NetworkID en el nivel de solicitud de compra o de artículo).

En la , se enumeran los proveedores de terceros y sus ID.

División de ofertas en varios pedidos

Los clientes que pagan con tarjetas de compra o que asignan sus productos a varias cuentas de contabilidad general pueden dividir las ofertas entre varios pedidos. Dado que los clientes siempre aceptan o rechazan la oferta completa como una unidad, esta división puede provocar excepciones en su sistema de entrada de pedidos.

Describa si esta situación provocaría excepciones. Si no puede procesar esos pedidos, describa el proceso para esas excepciones.

NotaLa frecuencia con la que se dan estas situaciones depende de los productos que ofrece, de cómo se clasifican y de los procesos de contabilidad de sus clientes.

Guía de soluciones cXMLPlanificación de sitios PunchOut

PUBLICPÚBLICO 97

Page 98: 355a de soluciones cXML - help.sap.com

Transacciones PunchOut

Las transacciones PunchOut determinan cómo se integra su sitio PunchOut con Ariba Network y aplicaciones de compra.

Catálogo de índice PunchOut [página 98]

Documento PunchOutSetupRequest [página 101]

Documento PunchOutSetupResponse [página 106]

Documento PunchOutOrderMessage [página 107]

URL de PunchOut [página 115]

Elementos URL frente a SelectedItem [página 117]

PunchOut de nivel 2 [página 117]

Requisitos de PunchOut de nivel 2 [página 122]

Ejemplos de catálogos de índice [página 123]

PunchOut a nivel de estantería [página 127]

Carga de catálogos de índice [página 127]

Tiempo límite para sesiones PunchOut [página 128]

Ejemplos ASP [página 128]

Catálogo de índice PunchOutUn catálogo de índice PunchOut es un archivo creado por el proveedor que la organización compradora carga en su aplicación de compras para crear un enlace PunchOut en la jerarquía de catálogo. El archivo define cómo aparece el catálogo PunchOut o los artículos PunchOut en el catálogo de la aplicación de compras.

Ariba Buyer y SAP Ariba Buying and Invoicing aceptan catálogos de índice PunchOut tanto CIF como cXML.

Elemento SupplierID [página 99]

Elemento URL [página 99]

Elemento Classification [página 99]

Atributo punchoutLevel [página 99]

Archivo de índice de PunchOut de ejemplo [página 100]

98PUBLICPÚBLICO

Guía de soluciones cXMLTransacciones PunchOut

Page 99: 355a de soluciones cXML - help.sap.com

Elemento SupplierID

El elemento SupplierID identifica el proveedor que aloja el catálogo PunchOut. Los proveedores utilizan los números ID de Ariba Network o Dun & Bradstreet D-U-N-S® para identificarse a sí mismos.

● Su ID de Ariba Network aparece en la página de inicio de su cuenta Ariba Network.● Encontrará información sobre números D-U-N-S en http://www.dnb.com

Elemento URL

En versiones anteriores de Ariba Network, el elemento URL identificaba el sitio Web de PunchOut del proveedor. Ahora, la URL procede del perfil cXML del proveedor o de la cuenta Ariba Network del proveedor.

El elemento URL todavía debe incluirse pero Ariba Network ya no lo utiliza.

Ariba Buyer transmite este valor en el documento PunchOutSetupRequest, de modo que el proveedor puede utilizarlo para identificar con más precisión el artículo de PunchOut.

Encontrará más información en URL de PunchOut [página 115].

Elemento Classification

Los artículos PunchOut de la aplicación de compras deben clasificarse para asignarlos a la jerarquía de catálogo. El sistema de clasificación de mercancías recomendado es UNSPSC (United Nations Standard Products and Services Code).

Encontrará más información en Códigos de mercancía [página 422].

Atributo punchoutLevel

Utilice el atributo opcional punchoutLevel para indicar a SAP Ariba Buying and Invoicing dónde colocar sus ofertas en el catálogo que se muestra a los usuarios finales. Esta atributo solo está disponible para SAP Ariba Buying and Invoicing (cXML 1.2.016 o posteriores). Está disponible para catálogos de índice PunchOut tanto cXML como CIF.

El atributo punchoutLevel puede tener los siguientes valores:

Valor Uso Ejemplo

store Una página de búsqueda que ofrece todos sus productos o servicios. Los usua­rios SAP Ariba Buying and Invoicing realizan el punch-out directamente sin mos­trar detalles de artículos. Estos artículos aparecen en la parte superior de las ca­tegorías, sobre los productos.

Tienda de hardware ACME

Guía de soluciones cXMLTransacciones PunchOut

PUBLICPÚBLICO 99

Page 100: 355a de soluciones cXML - help.sap.com

Valor Uso Ejemplo

aisle Páginas que agrupan sus artículos en un pequeño número de categorías. Los usuarios SAP Ariba Buying and Invoicing realizan el punch-out directamente sin mostrar detalles de artículos.

Herramientas de corte

shelf Páginas para productos similares entre los cuales los clientes eligen durante la compra. SAP Ariba Buying and Invoicing muestra detalles de artículos y permite a los usuarios efectuar un punch-out.

Serruchos

product Una página para cada uno de los artículos o UDA que ofrece. SAP Ariba Buying and Invoicing muestra detalles de artículos y permite a los usuarios efectuar un punch-out.

Serrucho Cuts-a-Lot de 14 pulgadas

Puede proporcionar una mezcla de artículos que tienen distintos valores punchoutLevel. Por ejemplo puede ofrecer a los usuarios un artículo PunchOut de nivel de tienda y un artículo PunchOut de nivel de producto para cada uno de sus 50 productos más conocidos. Si no incluye este atributo, SAP Ariba Buying and Invoicing considera que el artículo es un artículo de nivel de tienda.

Su sitio PunchOut puede interpretar el elemento SelectedItem en el documento PunchOutSetupRequest para determinar qué pasillo, estantería o producto seleccionan los usuarios. El PunchOut a nivel de estantería y PunchOut a nivel de producto son especialmente útiles si implementa el PunchOut de nivel 2. Consulte PunchOut de nivel 2 [página 117].

Archivo de índice de PunchOut de ejemplo

Cuando cree sus propios archivos de índice de PunchOut de nivel 2, créelos en formato cXML para que el tamaño del archivo sea pequeño. A modo de guía se proporciona un ejemplo de archivo PunchOut.

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE Index SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.016/cXML.dtd"><Index> <SupplierID domain="DUNS">1234567</SupplierID> <Comments xml:lang="en-US">Sample cXML Index Catalog</Comments> <IndexItem> <IndexItemPunchout> <ItemID> <SupplierPartID>123456</SupplierPartID> </ItemID> <PunchoutDetail punchoutLevel="store"> <Description xml:lang="en-US">Workchairs, Inc.</Description> <URL>http://www.workchairs.com</URL> <Classification domain="UNSPSC">88888889</Classification> </PunchoutDetail> </IndexItemPunchout> </IndexItem> </Index>

100PUBLICPÚBLICO

Guía de soluciones cXMLTransacciones PunchOut

Page 101: 355a de soluciones cXML - help.sap.com

Documento PunchOutSetupRequestPara iniciar sesiones PunchOut, los solicitantes seleccionan artículos PunchOut en su aplicación de compras. La aplicación de compras genera un documento cXML PunchOutSetupRequest y lo envía a Ariba Network, que lo transmite al sitio PunchOut. El documento PunchOutSetupRequest autentifica el comprador para el proveedor.

Elementos de credencial [página 101]

Elemento UserAgent [página 102]

Atributo operation PunchOutSetupRequest [página 102]

Elemento BuyerCookie [página 103]

Elementos extrínsecos [página 103]

Elemento BrowserFormPost [página 104]

Elemento SupplierSetup [página 104]

Elemento SelectedItem [página 104]

Documento PunchOutSetupRequest de ejemplo [página 105]

Elementos de credencial

Como otros documentos cXML, los documentos PunchOutSetupRequest contienen las credenciales From, To y Sender.

Credencial From

Este elemento identifica el originador de la PunchOutSetupRequest (la organización compradora).

<From> <Credential domain="NetworkID"> <Identity>AN01000002792</Identity> </Credential> </From>

Credencial To

Este elemento identifica el proveedor (el destinatario de la PunchOutSetupRequest.)

<To> <Credential domain="DUNS"> <Identity>942888711</Identity> </Credential> </To>

Guía de soluciones cXMLTransacciones PunchOut

PUBLICPÚBLICO 101

Page 102: 355a de soluciones cXML - help.sap.com

Para obtener más información sobre las restricciones de credenciales de las versiones anteriores de Ariba Buyer, consulte ID de Ariba Network y versiones anteriores de Ariba Buyer [página 47].

Credencial Sender

Cuando una aplicación de compras crea el documento PunchOutSetupRequest, la credencial Sender especifica la identidad y la clave compartida de la organización compradora. Cuando Ariba Network transmite el documento al proveedor, cambia la credencial Sender para especificar la identidad de Ariba Network y utiliza la SharedSecret del proveedor.

Este ejemplo muestra una PunchOutSetupRequest transmitida a través de Ariba Network.

<Sender> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Ariba Buyer 7.1</UserAgent> </Sender>

NotaSi el documento PunchOutSetupRequest procede de soluciones de compras Ariba, la credencial Sender es NetworkID.

Elemento UserAgentEl elemento UserAgent identifica la aplicación originaria. Está formado por el nombre de la compañía de software, el nombre del producto y la versión. Entre paréntesis pueden aparecer también detalles de la versión.

<UserAgent>Ariba Buyer 8.2</UserAgent>

Atributo operation PunchOutSetupRequestEl atributo operation especifica el tipo de sesión PunchOut que se ha de iniciar: create, edit o inspect.

operation Descripción

create Punch out para agregar un nuevo artículo PunchOut a una solicitud

edit Punch out para modificar un artículo PunchOut existente

inspect Punch out para inspeccionar (sólo lectura) un artículo PunchOut existente

Por ejemplo:

<PunchOutSetupRequest operation="create">

102PUBLICPÚBLICO

Guía de soluciones cXMLTransacciones PunchOut

Page 103: 355a de soluciones cXML - help.sap.com

Los proveedores pueden restringir la edición de sesiones PunchOut posteriores utilizando el atributo operationAllowed en el documento PunchOutOrderMessage. Encontrará más información en Atributo operationAllowed [página 108].

Elemento BuyerCookie

El elemento BuyerCookie transmite información que es opaca para el sitio PunchOut pero que debe ser devuelta al originador para todas las operaciones PunchOut posteriores. Permite a la aplicación de compras hacer coincidir múltiples solicitudes PunchOut pendientes. Es único por cada sesión PunchOut.

NotaCuando este elemento pasa por Ariba Network desde Ariba Buyer 7.0 (cXML 1.1), el proveedor recibe actualmente un número de ID de sesión y no el valor alfanumérico de la PunchOutSetupRequest de la aplicación de compras a Ariba Network.

Ejemplo

<BuyerCookie>1TF5JRP11S3W9</BuyerCookie>

Elementos extrínsecos

El elemento opcional Extrinsic se utiliza para cualquier dato adicional que el solicitante quiera transmitir al sitio PunchOut. En cXML 1.0, los elementos extrínsecos User y CostCenter a menudo proporcionan información de contacto.

NotaEn cXML 1.1, el elemento Contact sustituye al extrínseco User y a algunos otros incluidos habitualmente en documentos cXML 1.0.

Ariba Buyer 6.1 y 7.0 incluyen un conjunto distinto de extrínsecos. De forma predeterminada, Ariba Buyer 6.1 incluye los extrínsecos User y CostCenter. De forma predeterminada, Ariba Buyer 7.0 incluye los extrínsecos UniqueName, UserEmail y CostCenter. Cualquier otro extrínseco adicional debería ser acordado entre la organización compradora y el proveedor.

El siguiente ejemplo se transmite al departamento del usuario iniciando la operación de PunchOut.

<Extrinsic name="CostCenter">450</Extrinsic> <Extrinsic name="UniqueName">jsmith</Extrinsic>

En cXML 1.1 o posteriores utilice el elemento Contact en el cuerpo de la solicitud para identificar unívocamente al usuario (por ejemplo, John Smith de Finanzas en acme.com) en lugar de utilizar elementos extrínsecos. La organización compradora puede configurar su aplicación de compras para insertar Contact y datos extrínsecos.

Guía de soluciones cXMLTransacciones PunchOut

PUBLICPÚBLICO 103

Page 104: 355a de soluciones cXML - help.sap.com

Ejemplo

<Contact role=”endUser”> <Name xml:lang="en-US">Mr. Burns</Name> <Email>[email protected]</Email> <Phone name="Office"> ... </Phone> </Contact>

Elemento BrowserFormPost

El elemento BrowseFormPost contiene la URL al que el sitio PunchOut devuelve el PunchOutOrderMessage al final de la sesión PunchOut.

<BrowserFormPost> <URL>http://procure.bigbuyer.com:3377/punchout</URL> </BrowserFormPost>

Elemento SupplierSetup

En versiones cXML anteriores, el elemento SupplierSetup era la única forma de especificar una URL del sitio de PunchOut. A partir de cXML 1.1, los proveedores configuran Ariba Network con las URL de sus sitios de PunchOut y utilizan el nuevo elemento SelectedItem para especificar el PunchOut a nivel de tienda, de pasillo, de estantería o de producto.

El elemento SupplierSetup está obsoleto. Sin embargo, los sitios de PunchOut todavía deben aceptarlo hasta que todas las instalaciones Ariba Buyer reconozcan y envíen el elemento SelectedItem. Encontrará más información en URL de PunchOut [página 115].

Elemento SelectedItem

El elemento SelectedItem contiene el artículo seleccionado por el usuario en un catálogo e identifica el número de pieza del proveedor. Comenzando con cXML 1.1, las aplicaciones de compras utilizan el elemento SelectedItem para especificar el PunchOut a nivel de tienda, pasillo, estantería o producto.

<SelectedItem> <ItemID> <SupplierPartID>55555</SupplierPartID> </ItemID> </SelectedItem>

104PUBLICPÚBLICO

Guía de soluciones cXMLTransacciones PunchOut

Page 105: 355a de soluciones cXML - help.sap.com

Documento PunchOutSetupRequest de ejemplo

El documento PunchOutSetupRequest de ejemplo muestra cómo se desplaza una solicitud desde Ariba Network al sitio PunchOut del proveedor. Contiene la clave compartida del proveedor.

<?xml version="1.0"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd"><cXML payloadID="[email protected] " timestamp="2005-06-14T12:57:09-07:00"> <Header> <From> <Credential domain="NetworkID"> <Identity>AN01000002792</Identity> </Credential> </From> <To> <Credential domain="DUNS"> <Identity>12345678</Identity> </Credential> </To> <Sender> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]/Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Ariba Buyer 8.2</UserAgent> </Sender> </Header> <Request> <PunchOutSetupRequest operation="create"> <BuyerCookie>1J3YVWU9QWMTB</BuyerCookie> <Extrinsic name="CostCenter">610</Extrinsic> <Extrinsic name="User">jpicard</Extrinsic> <BrowserFormPost> <URL>http://bigbuyer.com:3377/punchout</URL> </BrowserFormPost> <SupplierSetup> <URL>https://punchout.workchairs.com/PunchOutServlet</URL> </SupplierSetup> <ShipTo> <Address addressID="001"> <Name xml:lang="en">BigBuyer Headquarters</Name> <PostalAddress> <DeliverTo>Jean Picard</DeliverTo> <Street>1565 Pine, MS A.2</Street> <City>New York</City> <State>NY</State> <PostalCode>01043</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> </Address> </ShipTo> <Contact> <Name>jpicard</Name> </Contact> <SelectedItem> <ItemID> <SupplierPartID>54543</SupplierPartID> </ItemID> </SelectedItem> </PunchOutSetupRequest> </Request> </cXML>

Guía de soluciones cXMLTransacciones PunchOut

PUBLICPÚBLICO 105

Page 106: 355a de soluciones cXML - help.sap.com

Documento PunchOutSetupResponse

Después de que los proveedores reciben documentos PunchOutSetupRequest, devuelven documentos PunchOutSetupResponse a Ariba Network a través de la misma conexión HTTPS que la PunchOutSetupRequest.

Resumen de los documentos PunchOutSetupResponse [página 106]

Elemento Status [página 106]

Elemento URL StartPage [página 106]

Documento PunchOutSetupResponse de ejemplo [página 107]

Resumen de los documentos PunchOutSetupResponse

El documento PunchOutSetupResponse indica si el inicio de PunchOut se ha llevado a cabo con éxito y proporciona la aplicación de compra con una URL de redireccionamiento a la página de inicio del sitio web del proveedor.

Ariba Network tiene un intervalo de 30 segundos para recibir documentos PunchOutSetupResponse. Si los proveedores no envían una respuesta dentro de este límite de tiempo, el inicio de la sesión PunchOut se cancela.

Elemento Status

El elemento Status indica el éxito o el fallo de una operación de solicitud. Está compuesto por un atributo code, un atributo text y un atributo opcional xml:lang.

El atributo code sigue el modelo de código de estado HTTP. En general, un código de serie 2xx indica una correcta comunicación cliente-servidor, un código de serie 4xx indica un estado de error del cliente y un código de serie 5xx un error de servidor. El atributo text y el atributo opcional xml:lang permite una descripción en forma de texto del estado devuelto en una respuesta. Los proveedores deberían poner el error del análisis XML o de la aplicación en el cuerpo del elemento Status .

Elemento URL StartPage

El documento PunchOutSetupResponse contiene un elemento URL que especifica la URL de la página de inicio para pasar al navegador del usuario para la sesión de navegador interactiva.

106PUBLICPÚBLICO

Guía de soluciones cXMLTransacciones PunchOut

Page 107: 355a de soluciones cXML - help.sap.com

Documento PunchOutSetupResponse de ejemplo

El documento PunchOutSetupResponse de ejemplo muestra una operación de solicitud exitosa.

<?xml version="1.0"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd"><cXML xml:lang="en-US" payloadID="933694607739" timestamp="2017-03-14T12:59:09-07:00"> <Response> <Status code="200" text="success"></Status> <PunchOutSetupResponse> <StartPage> <URL>https://punchout.workchairs.com/Servlet/sessionid=7006</URL> </StartPage> </PunchOutSetupResponse> </Response> </cXML>

Documento PunchOutOrderMessageEl documento PunchOutOrderMessage envía el contenido de la cesta de la compra del sitio PunchOut a la solicitud del usuario de la aplicación de compras. Proporciona detalles y precios de productos a aplicaciones de compras. Los proveedores también pueden enviar cookies de proveedor para asociar artículos a una sesión de compras específica.

El PunchOutOrderMessage proporciona una oferta para los artículos seleccionados pero los proveedores no han recibido aún ningún pedido de compra, de modo que este todavía no se puede reservar.

Los proveedores envían documentos PunchOutOrderMessage directamente a la aplicación de compras, no a Ariba Network. Las aplicaciones de compras no interpretan el elemento Sender en esos documentos, de modo que los proveedores deben duplicar la información del elemento From en el elemento Sender.

Ejemplo

<From> <Credential domain="NetworkID"> <Identity>AN01012345678</Identity> </Credential></From><To> <Credential domain="NetworkID"> <Identity>AN01000002792</Identity> </Credential></To><Sender> <Credential domain="NetworkID"> <Identity>AN01012345678</Identity> </Credential> <UserAgent>Our PunchOut Site V4.2</UserAgent> </Sender>

Guía de soluciones cXMLTransacciones PunchOut

PUBLICPÚBLICO 107

Page 108: 355a de soluciones cXML - help.sap.com

Los proveedores no deben enviar una clave compartida, ya que ese valor es confidencial entre cada proveedor y Ariba Network.

Atributo operationAllowed [página 108]

cxml-base64 y cxml-urlencoded [página 108]

Elemento BuyerCookie [página 109]

Elemento Total [página 109]

Elemento ItemIn [página 109]

Elemento ItemID [página 110]

Elemento ItemDetail [página 111]

Documento PunchOutOrderMessage de ejemplo [página 113]

Atributo operationAllowed

El atributo operationAllowed controla si las aplicaciones de compras pueden iniciar una sesión PunchOut posterior que contiene datos de este documento PunchOutOrderMessage. A este atributo se le puede asignar un valor de create, inspect o edit.

Si operationAllowed=“create”, las aplicaciones de compras pueden generar únicamente un documento OrderRequest. De otro modo, la aplicación de compras puede inspeccionar o editar el carrito de la compra iniciando documentos PunchOutSetupRequest posteriores con las operaciones adecuadas y los elementos ItemOut correspondientes a la lista ItemIn devuelta en un documento PunchOutOrderMessage. Si se soporta edit, eso implica que se soporta inspect.

cxml-base64 y cxml-urlencoded

Los atributos cxml-base64 y cxml-urlencoded del elemento HTML input identifican el campo de formulario oculto que almacena el documento cXMLPunchOutOrderMessage. El proveedor debe codificar el documento PunchOutOrderMessage utilizando la codificación base64 o URL e indicar qué codificación se ha utilizado en el atributo name del campo de formulario.

Ejemplo

<input type="hidden" name="cxml-base64" value= "Entire text of base64-encoded cXML PunchOutOrderMessage document">

o

<input type="hidden" name=" cxml-urlencoded" value= "Entire text of URL-encoded cXML PunchOutOrderMessage document">

108PUBLICPÚBLICO

Guía de soluciones cXMLTransacciones PunchOut

Page 109: 355a de soluciones cXML - help.sap.com

Los proveedores pueden utilizar cxml-urlencoded en cXML 1.1 y posteriores.

Elemento BuyerCookieEl elemento BuyerCookie es utilizado por aplicaciones de compras para asociar un determinado PunchOutOrderMessage con su PunchOutSetupRequest de origen. Los sitios PunchOut deben devolver este elemento siempre que aparece. El documento PunchOutOrderMessage debe contener la misma BuyerCookie utilizada en el documento PunchOutSetupRequest para esta sesión PunchOut.

No utilice la BuyerCookie para realizar un seguimiento de sesiones PunchOut porque esta varía para cada sesión, desde la de creación hasta la de inspección o edición.

Ejemplo

<BuyerCookie>1TF5JRP11S3W9</BuyerCookie>

Ariba Buyer descarta la cookie después de utilizarla.

NotaEl valor BuyerCookie puede vencer mientras el usuario navega por su sitio. Es posible que los proveedores quieran suportar la recreación del último carrito de la compra de un usuario específico. Si se proporciona, debe ser una opción y sólo para ese usuario.

Elemento TotalEl elemento Total contiene el valor total para el pedido: cantidad * precio sin expedición e impuestos.

Ejemplo

<Total> <Money currency="USD">100.23</Money> </Total>

Encontrará más información sobre el elemento Money en Formato de dinero [página 25].

Elemento ItemInEl elemento ItemIn devuelve detalles del artículo PunchOut a la solicitud.

Guía de soluciones cXMLTransacciones PunchOut

PUBLICPÚBLICO 109

Page 110: 355a de soluciones cXML - help.sap.com

Ejemplo

<ItemIn quantity="1"> <ItemID> <SupplierPartID>1234</SupplierPartID> <SupplierPartAuxiliaryID>ARB-65-1</SupplierPartAuxiliaryID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">2.10</Money> </UnitPrice> <Description xml:lang="en">3M POST-IT Cube, printed logo in 2 colors on side. 1 3/8 x 2 3/4 post-it cube of white paper. Approximately 345 sheets. (Refill) </Description> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="UNSPSC">14111514</Classification> </ItemDetail> </ItemIn>

Este elemento también puede contener los atributos itemType y parentLineNumber para un grupo de artículos que tienen artículos en línea secundarios. Encontrará más información en Elemento ItemOut [página 168].

Información relacionada

Referencia sobre formato de catálogo

Elemento ItemID

El elemento ItemID contiene SupplierPartID y SupplierPartAuxiliaryID.

Los proveedores pueden utilizar el elemento SupplierPartAuxiliaryID como una cookie de proveedor para transportar información de configuración compleja y de mercancías para identificar el artículo cuando se presente en el futuro. Si SupplierPartAuxiliaryID contiene caracteres especiales, por ejemplo elementos XML adicionales no definidos en el protocolo cXML, estos deben evitarse convenientemente.

Las organizaciones compradoras no muestran el elemento SupplierPartAuxiliaryID; en su lugar lo devuelven en documentos OrderRequest para que lo utilicen los proveedores.

Ejemplo

<ItemID> <SupplierPartID>1234</SupplierPartID> <SupplierPartAuxiliaryID>ARB-65-1</SupplierPartAuxiliaryID> </ItemID>

110PUBLICPÚBLICO

Guía de soluciones cXMLTransacciones PunchOut

Page 111: 355a de soluciones cXML - help.sap.com

NotaLas aplicaciones de compras utilizan SupplierPartAuxiliaryID como parte del identificador unívoco para artículos, de modo que los sitios PunchOut no deben cambiar este valor durante las sesiones PunchOut edit o inspect.

Elemento ItemDetail

El elemento ItemDetail contiene propiedades detalladas de un artículo en línea, como por ejemplo el precio por unidad, la descripción, la unidad de medida y PriceBasisQuantity.

Ejemplo

<ItemDetail> <UnitPrice> <Money currency="USD">0.10</Money> </UnitPrice> <Description xml:lang="en">ACME Push Pins; Clear; Box Of 20</Description> <UnitOfMeasure>EA</UnitOfMeasure> <PriceBasisQuantity quantity = “2” conversionFactor = “0.10” <UnitOfMeasure>BX</UnitOfMeasure> <Description xml:lang = "en">This field specifies that 1 Box is equivalent to 10 EA and the unit price is for 2 Boxes</Description> </PriceBasisQuantity <Classification domain="UNSPSC">4412210601</Classification> <ManufacturerPartID>ISBN-23455634</ManufacturerPartID> <ManufacturerName>Acme Manufacturing USA, Inc.</ManufacturerName> <LeadTime>4</LeadTime> </ItemDetail>

Elemento UnitPrice

El elemento UnitPrice contiene el precio por unidad del artículo.

UnitPrice debe aparecer necesariamente en el PunchOutOrderMessage para el posterior proceso por parte de aplicaciones de compra. El usuario debería poder "editar" una solicitud incluso si UnitPrice no se ha devuelto.

Elemento Description

El elemento Description contiene la descripción del artículo.

Guía de soluciones cXMLTransacciones PunchOut

PUBLICPÚBLICO 111

Page 112: 355a de soluciones cXML - help.sap.com

Elemento UnitOfMeasure

El elemento UnitOfMeasure contiene el código de unidad de medida del artículo como se define en la norma de las Naciones Unidas para unidades de medida.

Encontrará más información en Sistemas de codificación recomendados [página 422].

Elemento PriceBasisQuantity

El elemento PriceBasisQuantity contiene la determinación de precios basada en la cantidad para un artículo en línea. Generalmente, a la determinación de precios basada en la cantidad también se le denomina cantidad basada en el precio. La determinación de precios basada en la cantidad permite basar el precio por unidad de un artículo en una cantidad de unidad de precio distinta de 1.

Además de la determinación de precios basada en la cantidad, la determinación de precios mediante conversión de unidades permite la conversión de la unidad de medida en el cálculo de la determinación de precios si la unidad de medida del pedido es distinta de la unidad de medida de la determinación de precios.

PriceBasisQuantity se rellena en el cXML de destino solo si la longitud de la cadena del elemento es PriceUnit mayor que cero.

Ejemplo

<ItemOut isAdHoc = "yes" lineNumber = "1" quantity = "10" requestedDeliveryDate = "2012-03-07"> <ItemID> <SupplierPartID>N160INSTLL</SupplierPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency = "USD">14.00000</Money> </UnitPrice> <Description xml:lang = "en">N160INSTLL</Description> <UnitOfMeasure>EA</UnitOfMeasure> <PriceBasisQuantity quantity = "2" conversionFactor = "0.10"> <UnitOfMeasure>BX</UnitOfMeasure> <Description xml:lang = "en">This field specifies that 1 Box is equivalent to 10 EA and the unit price is for 2 Boxes</Description> </PriceBasisQuantity> . . , </ItemDetail

112PUBLICPÚBLICO

Guía de soluciones cXMLTransacciones PunchOut

Page 113: 355a de soluciones cXML - help.sap.com

Elemento Classification

El elemento Classification contiene el código de mercancía UNSPSC. Ariba Buyer 8.0 y versiones posteriores y SAP Ariba Buying and Invoicing reconocen un número de versión UNSPSC opcional.

Ejemplos

<Classification domain="UNSPSC">4412210601</Classification> <Classification domain="UNSPSC_V7.1">4412210601</Classification>

Para obtener más información, consulte Sistemas de codificación recomendados [página 422].

Elemento LeadTime

Ariba Buyer 8.2 (cXML 1.2.011) y posteriores y SAP Ariba Buying and Invoicing pueden interpretar un elemento LeadTime en el elemento ItemDetail. Los sitios PunchOut pueden incluir LeadTime para indicar cuántos días laborables pasarán desde que se reciba el pedido de compra hasta que se entregue el producto.

Documento PunchOutOrderMessage de ejemplo

El PunchOutOrderMessage de ejemplo ilustra cómo el documento está oculto dentro de un campo de formulario cxml-urlencoded.

<input type="hidden" name="cxml-urlencoded" value="<!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd"> <cXML payloadID="958074737352&www.workchairs.com" timestamp="2004-06-14T12:59:09-07:00"> <Header> <From> <Credential domain="DUNS"> <Identity>12345678</Identity> </Credential> </From> <To> <Credential domain="NetworkID"> <Identity>AN01000002792</Identity> </Credential> </To> <Sender> <Credential domain="www.workchairs.com"> <Identity>PunchoutResponse</Identity> </Credential> <UserAgent>Our PunchOut Site V4.2</UserAgent> </Sender> </Header> <Message> <PunchOutOrderMessage> <BuyerCookie>1J3YVWU9QWMTB</BuyerCookie> <PunchOutOrderMessageHeader operationAllowed="edit">

Guía de soluciones cXMLTransacciones PunchOut

PUBLICPÚBLICO 113

Page 114: 355a de soluciones cXML - help.sap.com

<Total> <Money currency="USD">14.27</Money> </Total> </PunchOutOrderMessageHeader> <ItemIn quantity="2"> <ItemID> <SupplierPartID>3171 04 20</SupplierPartID> <SupplierPartAuxiliaryID>ContractId=1751 ItemId=417714 </SupplierPartAuxiliaryID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">1.22</Money> </UnitPrice> <Description xml:lang="en">ADAPTER; TUBE; 5/32"; MALE; #10-32 UNF; FITTING </Description> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="UNSPSC">21101510</Classification> <ManufacturerName>Dogwood</ManufacturerName> </ItemDetail> </ItemIn> <ItemIn quantity="1"> <ItemID> <SupplierPartID>3801 04 20</SupplierPartID> <SupplierPartAuxiliaryID> ContractId=1751 ItemId=417769 </SupplierPartAuxiliaryID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">11.83</Money> </UnitPrice> <Description xml:lang="en">ADAPTER; TUBE; 5/32"; 2 PER PACK; MALE #10-32 UNF; STAINLESS STEEL; FITTING< </Description> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="UNSPSC">21101510</Classification> <ManufacturerName>Legris</ManufacturerName> <LeadTime>2</LeadTime> </ItemDetail> <SupplierID domain="DUNS">022878979</SupplierID> </ItemIn> </PunchOutOrderMessage> </Message></cXML> ">

Más abajo se muestra el mismo ejemplo, pero con codificación base64. Los proveedores deberían utilizar la codificación base64 si hay caracteres no US-ASCII en el documento PunchOutOrderMessage.

<input type="hidden" name="cxml-base64" value= "PCFET0NUWVBFIGNYTUwgU1lTVEVNICJodHRwOi8veG1sLmN4bWwub3JnL3NjaGVtYXMvY1hNTC8xLjIuMDExL2NYTUwuZHRkIj4NCjxjWE1MIHBheWxvYWRJRD0iOTU4MDc0NzM3MzUyQHd3dy53b3JrY2hhaXJzLmNvbSINCiB0aW1lc3RhbXA9IjIwMDQtMDYtMTRUMTI6NTk6MDktMDc6MDAiPg0KICAgPEhlYWRlcj4NCiAgICAgIDxGcm9tPg0KICAgICAgICAgPENyZWRlbnRpYWwgZG9tYWluPSJEVU5TIj4NCiAgICAgICAgICAgIDxJZGVudGl0eT4xMjM0NTY3ODwvSWRlbnRpdHk+DQogICAgICAgICA8L0NyZWRlbnRpYWw+DQogICAgICA8L0Zyb20+DQogICAgICA8VG8+DQogICAgICAgICA8Q3JlZGVudGlhbCBkb21haW49Ik5ldHdvcmtJZCI+DQogICAgICAgICAgICA8SWRlbnRpdHk+QU4wMTAwMDAwMjc5MjwvSWRlbnRpdHk+DQogICAgICAgICA8L0NyZWRlbnRpYWw+DQogICAgICA8L1RvPg0KICAgICAgPFNlbmRlcj4NCiAgICAgICAgIDxDcmVkZW50aWFsIGRvbWFpbj0id3d3LndvcmtjaGFpcnMuY29tIj4NCiAgICAgICAgICAgIDxJZGVudGl0eT5QdW5jaG91dFJlc3BvbnNlPC9JZGVudGl0eT4NCiAgICAgICAgIDwvQ3JlZGVudGlhbD4NCiAgICAgICAgIDxVc2VyQWdlbnQ+T3VyIFB1bmNoT3V0IFNpdGUgVjQuMjwvVXNlckFnZW50Pg0KICAgICAgPC9TZW5kZXI+DQogICA8L0hlYWRlcj4NCiAgIDxNZXNzYWdlPg0KICAgICAgPFB1bmNoT3V0T3JkZXJNZXNzYWdlPg0KICAgICAgICAgPEJ1eWVyQ29va2llPjFKM1lWV1U5UVdNVEI8L0J1eWVyQ29va2llPg0KICAgICAgICAgPFB1bmNoT3V0T3JkZXJNZXNzYWdlSGVhZGVyIG9wZXJhdGlvbkFsbG93ZWQ9ImVkaXQiPg0KICAgICAgICAgICAgPFRvdGFsPg0KICAgICAgICAgICAgICAgPE1vbmV5IGN1cnJlbmN5PSJVU0QiPjE0LjI3PC9Nb25leT4NCiAgICA

114PUBLICPÚBLICO

Guía de soluciones cXMLTransacciones PunchOut

Page 115: 355a de soluciones cXML - help.sap.com

gICAgICAgIDwvVG90YWw+DQogICAgICAgIDwvUHVuY2hPdXRPcmRlck1lc3NhZ2VIZWFkZXI+DQogICAgICAgIDxJdGVtSW4gcXVhbnRpdHk9IjIiPg0KICAgICAgICAgICAgPEl0ZW1JRD4NCiAgICAgICAgICAgICAgICA8U3VwcGxpZXJQYXJ0SUQ+MzE3MSAwNCAyMDwvU3VwcGxpZXJQYXJ0SUQ+DQogICAgICAgICAgICAgICAgPFN1cHBsaWVyUGFydEF1eGlsaWFyeUlEPkNvbnRyYWN0SWQ9MTc1MSBJdGVtSWQ9NDE3NzE0DQogICAgICAgICAgICAgICAgPC9TdXBwbGllclBhcnRBdXhpbGlhcnlJRD4NCiAgICAgICAgICAgIDwvSXRlbUlEPg0KICAgICAgICAgICAgPEl0ZW1EZXRhaWw+DQogICAgICAgICAgICAgICAgPFVuaXRQcmljZT4NCiAgICAgICAgICAgICAgICAgIDxNb25leSBjdXJyZW5jeT0iVVNEIj4xLjIyPC9Nb25leT4NCiAgICAgICAgICAgICAgIDwvVW5pdFByaWNlPg0KICAgICAgICAgICAgICAgPERlc2NyaXB0aW9uIHhtbDpsYW5nPSJlbiI+QURBUFRFUjsgVFVCRTsgNS8zMiI7IE1BTEU7ICMxMC0zMiBVTkY7IEZJVFRJTkc8L0Rlc2NyaXB0aW9uPg0KICAgICAgICAgICAgICAgPFVuaXRPZk1lYXN1cmU+RUE8L1VuaXRPZk1lYXN1cmU+DQogICAgICAgICAgICAgICA8Q2xhc3NpZmljYXRpb24gZG9tYWluPSJVTlNQU0MiPjIxMTAxNTEwPC9DbGFzc2lmaWNhdGlvbj4NCiAgICAgICAgICAgICAgIDxNYW51ZmFjdHVyZXJOYW1lPkRvZ3dvb2Q8L01hbnVmYWN0dXJlck5hbWU+DQogICAgICAgICAgICA8L0l0ZW1EZXRhaWw+DQogICAgICAgICA8L0l0ZW1Jbj4NCiAgICAgICAgIDxJdGVtSW4gcXVhbnRpdHk9IjEiPg0KICAgICAgICAgICAgPEl0ZW1JRD4NCiAgICAgICAgICAgICAgIDxTdXBwbGllclBhcnRJRD4zODAxIDA0IDIwPC9TdXBwbGllclBhcnRJRD4NCiAgICAgICAgICAgICAgIDxTdXBwbGllclBhcnRBdXhpbGlhcnlJRD4NCiAgICAgICAgICAgICAgICAgIENvbnRyYWN0SWQ9MTc1MSBJdGVtSWQ9NDE3NzY5DQogICAgICAgICAgICAgICA8L1N1cHBsaWVyUGFydEF1eGlsaWFyeUlEPg0KICAgICAgICAgICAgPC9JdGVtSUQ+DQogICAgICAgICAgICA8SXRlbURldGFpbD4NCiAgICAgICAgICAgICAgIDxVbml0UHJpY2U+DQogICAgICAgICAgICAgICAgICA8TW9uZXkgY3VycmVuY3k9IlVTRCI+MTEuODM8L01vbmV5Pg0KICAgICAgICAgICAgICAgPC9Vbml0UHJpY2U+DQogICAgICAgICAgICAgICA8RGVzY3JpcHRpb24geG1sOmxhbmc9ImVuIj5BREFQVEVSOyBUVUJFOyA1LzMyIjsgMiBQRVIgUEFDSzsgTUFMRSAjMTAtMzIgVU5GOyBTVEFJTkxFU1MgU1RFRUw7IEZJVFRJTkc8L0Rlc2NyaXB0aW9uPg0KICAgICAgICAgICAgICAgPFVuaXRPZk1lYXN1cmU+RUE8L1VuaXRPZk1lYXN1cmU+DQogICAgICAgICAgICAgICA8Q2xhc3NpZmljYXRpb24gZG9tYWluPSJVTlNQU0MiPjIxMTAxNTEwPC9DbGFzc2lmaWNhdGlvbj4NCiAgICAgICAgICAgICAgIDxNYW51ZmFjdHVyZXJOYW1lPkxlZ3JpczwvTWFudWZhY3R1cmVyTmFtZT4NCiAgICAgICAgICAgICAgIDxMZWFkVGltZT4yPC9MZWFkVGltZT4NCiAgICAgICAgICAgIDwvSXRlbURldGFpbD4NCiAgICAgICAgICAgIDxTdXBwbGllcklEIGRvbWFpbj0iRFVOUyI+MDIyODc4OTc5PC9TdXBwbGllcklEPg0KICAgICAgICAgPC9JdGVtSW4+DQogICAgICA8L1B1bmNoT3V0T3JkZXJNZXNzYWdlPg0KICAgPC9NZXNzYWdlPg0KPC9jWE1MPg=”>

URL de PunchOutAriba Network recibe solicitudes PunchOut de compradores y las envía a sitios PunchOut de proveedores.

Hay tres métodos que los proveedores pueden utilizar para especificar las URL de sus sitios PunchOut. En orden de preferencia son los siguientes:

● URL especificada en el sitio PunchOut del proveedor [página 115]● URL especificada en Ariba Network [página 116]● URL especificado en el catálogo de índice del proveedor (obsoleto) [página 116]

URL especificada en el sitio PunchOut del proveedorTodos los sitios PunchOut cXML 1.1 (y posteriores) deben especificar su URL de PunchOut a través de la transacción de perfil cXML.

Los proveedores especifican su URL ProfileRequest en el área Configuración de sus cuentas Ariba Network y Ariba Network envía periódicamente documentos ProfileRequest para consultar esos sitios. Los sitios responden con un documento ProfileResponse en el que se listan las URL para todas las solicitudes cXML que soportan, incluido la URL para solicitudes PunchOut. Ariba Network transmite los documentos PunchOutSetupRequest a esa URL. Este método se recomienda porque los proveedores pueden cambiar sus URL sin tener que iniciar sesión en Ariba Network. Encontrará más información sobre perfiles cXML en Transacción de perfil [página 73].

Guía de soluciones cXMLTransacciones PunchOut

PUBLICPÚBLICO 115

Page 116: 355a de soluciones cXML - help.sap.com

Si los proveedores no especifican una URL de perfil en Ariba Network, se utiliza el método descrito en URL especificada en Ariba Network [página 116] para determinar sus URL de PunchOut.

URL especificada en Ariba Network

Si los proveedores no soportan la transacción de perfil cXML, Ariba Network verifica si han introducido una URL en su cuenta. Los proveedores pueden especificar la URL de su sitio PunchOut en el área Configuración de sus cuentas Ariba Network.

Si no hay ninguna URL disponible ni del perfil cXML del proveedor ni de la cuenta Ariba Network del proveedor, la solicitud PunchOut fallará.

URL especificado en el catálogo de índice del proveedor (obsoleto)

La URL especificada en el método de catálogo de índice del proveedor para especificar una URL de PunchOut ya no se soporta. Los catálogos de índice PunchOut deben seguir existiendo para especificar esta URL, pero Ariba Network no lo utiliza como destino PunchOutSetupRequest.

Esta URL se genera a partir del storeFrontURL o del PunchoutDetail URL en función de dónde esté el solicitante en el momento del Punchout. En cualquier caso, este valor aparece en PunchOutSetupRequest.

Las versiones anteriores de Ariba Network enviaban documentos cXML PunchOutSetupRequest a la URL contenido en esos documentos. Para mejorar la seguridad, ahora Ariba Network ignora esas URL. Ariba Network transmite ahora documentos PunchOutSetupRequest al URL especificado en el perfil cXML de la organización receptora o en su cuenta Ariba Network.

Ejemplo

La URL del catálogo de índice aparece en el elemento SupplierSetup para el documento PunchOutSetupRequest. Los siguientes ejemplos muestran catálogos de índice tanto cXML como CIF y el PunchOutSetupRequest resultante:

Catálogo de índice cXML:

<PunchoutDetail> <Description xml:lang="en-US">Desk Chairs</Description> <URL>https://www.workchairs.com/punchout.asp</URL> <Classification domain="UNSPSC">5136030000</Classification> </PunchoutDetail>

Catálogo de índice CIF:

CIF_I_V3.0 CODEFORMAT: UNSPSCCOMMENTS: This is an example of a PunchOut catalog item

116PUBLICPÚBLICO

Guía de soluciones cXMLTransacciones PunchOut

Page 117: 355a de soluciones cXML - help.sap.com

FIELDNAMES: Supplier ID, Supplier Part ID, Manufacturer Part ID, Item Description, SPSC Code, Unit Price, Unit of Measure, Lead Time, Manufacturer Name, Supplier URL, Manufacturer URL, Market Price, PunchOut EnabledCURRENCY: USDDATA 762311901,A2C-311F,C-311F,"Desk Chairs",11116767,,,,,https://www.workchairs.com/punchout.asp,,,t ENDOFDATA

Segmento PunchOutSetupRequest resultante:

<SupplierSetup> <URL>https://www.workchairs.com/punchout.asp</URL> </SupplierSetup>

Elementos URL frente a SelectedItemEn función de la versión cXML utilizada por los sitios PunchOut, la PunchOutSetupRequest también puede contener un elemento SelectedItem que especifique el artículo para el que el usuario efectúa el punch-out.

● Las versiones Ariba Buyer 6.1 y anteriores (cXML 1.0) no utilizan SelectedItem. De este modo, las URL procedentes de catálogos de índice PunchOut son la única forma de especificar artículos para punch-out.

● Las versiones Ariba Buyer 7 y posteriores, así como SAP Ariba Buying and Invoicing (cXML 1.1 y posteriores) utilizan SelectedItem para especificar los artículos para el PunchOut. SelectedItem utiliza el ID de pieza de proveedor y el ID auxiliar de pieza de proveedor para identificar el artículo. Los sitios PunchOut pueden ignorar la URL en la PunchOutSetupRequest, de modo que los proveedores pueden utilizar URL ficticios en sus catálogos de índice.

PunchOut de nivel 2PunchOut de nivel 2 permite que las organizaciones compradoras busquen y encuentren artículos PunchOut dentro de su aplicación de compra, en lugar de tener que buscar directamente en el sitio de cada proveedor.

Las organizaciones compradoras desean una mejor capacidad y calidad de búsqueda en el catálogo cuando utilizan la interfaz de búsqueda en Ariba Buyer y SAP Ariba Buying and Invoicing para buscar artículos de catálogo de PunchOut. Desean obtener los mejores resultados cuando buscan tanto en catálogos CIF locales como en catálogos de PunchOut gestionados por proveedores.

El nivel 2 hace que los productos de los proveedores estén más accesibles para las organizaciones compradoras, incrementa la visibilidad de los productos de los proveedores y aumenta las visitas a los sitios PunchOut de los proveedores. Es compatible con Ariba Buyer y SAP Ariba Buying and Invoicing.

NotaSi sus clientes utilizan SAP Ariba Buying and Invoicing, utilice el atributo punchoutLevel en sus catálogos de índice para indicar dónde deben colocarse sus artículos en el catálogo de la aplicación de compras. Encontrará más información en Atributo punchoutLevel [página 99].

Guía de soluciones cXMLTransacciones PunchOut

PUBLICPÚBLICO 117

Page 118: 355a de soluciones cXML - help.sap.com

Visualización y búsqueda de artículos [página 118]

Mecanismo del PunchOut de nivel 2 [página 118]

Mecanismo de sesión de compras en curso de PunchOut de nivel 2 [página 119]

Formato de PunchOut de nivel 2 [página 121]

Información relacionada

Atributo PunchOutLevel

Visualización y búsqueda de artículosPara entender las ventajas de PunchOut de nivel 2 tiene que saber cómo encuentran los productos las organizaciones compradoras.

Con el PunchOut de nivel 2, los usuarios aprenden la semántica del mecanismo de búsqueda básico de su aplicación de compras en lugar de tener que aprender los mejores medios para buscar en cada sitio PunchOut del proveedor.

Si la organización compradora utiliza una aplicación de compras de SAP Ariba, los proveedores pueden incluir atributos jerárquicos para especificar cómo mostrar el artículo de PunchOut en el catálogo del sistema de compras. Los atributos punchoutLevel store, aisle, shelf o product hacen que el artículo se muestre de forma diferente en el catálogo. Por ejemplo, los atributos aisle y shelf hacen referencia a grupos de artículos relacionados. Estos artículos aparecen en la parte superior de las categorías, sobre los productos. Si el proveedor no especifica un atributo punchoutLevel, las aplicaciones de compras consideran que el artículo es un artículo de nivel de tienda.

Los usuarios pueden encontrar los artículos PunchOut utilizando una palabra clave o la búsqueda del proveedor. Se pueden buscar las siguientes palabras clave:

● Item Description● Short Name● Supplier Name● Buyer Part ID● Supplier Part ID● Manufacturer Part ID

Mecanismo del PunchOut de nivel 2Una vez que se ha encontrado un artículo, el usuario accede al sitio PunchOut del proveedor para obtener información más detallada del producto, determinar el precio actual y configurar productos.

El usuario debe disponer de la opción (un botón de un solo clic) de agregar el artículo visualizado a la solicitud y de volver inmediatamente a la aplicación SAP Ariba. Los proveedores también deberían agregar un botón Navegar para permitir a los usuarios adquirir otros artículos en el sitio del proveedor.

118PUBLICPÚBLICO

Guía de soluciones cXMLTransacciones PunchOut

Page 119: 355a de soluciones cXML - help.sap.com

Los siguientes pasos ilustran una experiencia típica de un usuario:

1. Un usuario crea una solicitud y busca productos. El sistema de compras muestra todo el contenido que coincide con lo buscado.

2. El usuario elige uno de los productos del proveedor y hace clic en Comprar de proveedor.3. El sitio PunchOut del proveedor muestra más detalles del producto y la determinación del precio actual para el

artículo especificado.4. El usuario introduce la cantidad en el sitio de PunchOut del proveedor y hace clic en Agregar a la solicitud y

volver a Ariba o en Examinar para continuar comprando en el sitio de PunchOut [página 119].En función de la elección del usuario, el sitio de PunchOut devuelve inmediatamente el usuario y el artículo seleccionado a la solicitud en la aplicación SAP Ariba o el usuario sigue examinando el sitio.

Mecanismo de sesión de compras en curso de PunchOut de nivel 2Los usuarios a menudo compran diversos artículos durante una sesión de compras. La solución de PunchOut de nivel 2 permite a los usuarios acceder a múltiples artículos durante su sesión de compras antes de volver a la aplicación SAP Ariba para finalizar una solicitud.

Para permitir la experiencia de compras en curso, los proveedores deben agregar un botón Navegar para permitir a los usuarios compras artículos adicionales en el sitio de PunchOut del proveedor. También tienen que soportar el mecanismo de sesión de compra continua que se describe a continuación.

Los siguientes pasos ilustran una típica sesión de compra continua:

1. Un usuario crea una solicitud y busca productos. El sistema de compras muestra todo el contenido que coincide con lo buscado.

2. El usuario elige uno de los productos del proveedor y hace clic en Comprar de proveedor.1. El primer PunchOutSetupRequest contiene operation="create" y el elemento SelectedItem

contiene el SupplierPartID del artículo seleccionado (consulte PunchOutSetupRequest resultante [página 125]).

2. Se valida el elemento SelectedItem y se enruta al usuario al artículo en el catálogo en el nivel de PunchOut especificado: pasillo, estantería o producto.

3. El sitio PunchOut del proveedor muestra más detalles del producto y la determinación del precio actual para el artículo especificado.

4. El usuario introduce la cantidad en el sitio de PunchOut del proveedor y hace clic en Navegar para continuar con las compras en el sitio de PunchOut.1. El sitio transfiere los contenidos del carrito de compra de vuelta a la solicitud del usuario en la aplicación

SAP Ariba.2. Cuando el proveedor permite la edición del carrito de compra, el documento PunchOutOrderMessage

contiene operationAllowed="edit". El usuario puede iniciar una sesión PunchOut posterior que contenga los datos de este documento PunchOutOrderMessage. Consulte la página PunchOut de nivel 2 [página 117].

5. El usuario continua comprando, selecciona otro artículo en su aplicación SAP Ariba y hace clic en Comprar del proveedor.1. El segundo PunchOutSetupRequest contiene operation="edit" para volver a abrir el carrito de

compra creado anteriormente para su modificación. El elemento SelectedItem en PunchOutSetupRequest contiene el SupplierPartID del segundo artículo seleccionado.

Guía de soluciones cXMLTransacciones PunchOut

PUBLICPÚBLICO 119

Page 120: 355a de soluciones cXML - help.sap.com

2. Se valida el elemento SelectedItem y se enruta al usuario al artículo en el catálogo en el nivel de PunchOut especificado: pasillo, estantería o producto.

3. Se desplazan los artículos en el elemento ItemOut al carrito de compra en la aplicación SAP Ariba.6. El usuario introduce la cantidad para el segundo artículo en el sitio de PunchOut del proveedor y hace clic en

Agregar a solicitud de compra y Volver a Ariba Buyer.El sitio de PunchOut devuelve el usuario y los artículos seleccionado a la solicitud en la aplicación SAP Ariba.

Ejemplo de un PunchOutSetupRequest para una sesión de compras en curso

<Request> <PunchOutSetupRequest operation="edit"> <BuyerCookie>I2OKSTKFBYJM</BuyerCookie> <Extrinsic name="UniqueName">Bjorn</Extrinsic> <Extrinsic name="UserEmail">[email protected]</Extrinsic> <Extrinsic name="CompanyCode">1095</Extrinsic> <BrowserFormPost> <URL>https://s1-eu.ariba.com/Buyer/punchout?</URL> </BrowserFormPost> <SupplierSetup> <URL>https://xmlgateway</URL> </SupplierSetup> <ShipTo> <Address addressID="0234"> <Name xml:lang="en">234</Name> <PostalAddress> <DeliverTo>Bjorn</DeliverTo> <Street>Punter 1234</Street> <City>Amsterdam</City> <PostalCode>28832</PostalCode> <Country isoCountryCode="NL">Netherlands</Country> </PostalAddress> </Address> </ShipTo> <SelectedItem> <ItemID> <SupplierPartID>4131178</SupplierPartID> <SupplierPartAuxiliaryID/> </ItemID> </SelectedItem> <ItemOut quantity="1" lineNumber="1"> <ItemID> <SupplierPartID>4117011</SupplierPartID> <SupplierPartAuxiliaryID>0000018RHI</SupplierPartAuxiliaryID> </ItemID> </ItemOut> </PunchOutSetupRequest> </Request>

NotaCuando los proveedores no permiten a los usuarios editar el carrito de compra, el documento PunchOutOrderMessage contiene operationAllowed="create" y PunchOutSetupRequest no tiene elementos ItemOut. Para obtener más información, consulte Documento PunchOutOrderMessage [página 107].

120PUBLICPÚBLICO

Guía de soluciones cXMLTransacciones PunchOut

Page 121: 355a de soluciones cXML - help.sap.com

Información relacionada

Tiempo límite para sesiones PunchOut [página 128]

Formato de PunchOut de nivel 2

Los catálogos estáticos, los catálogos de índice PunchOut a nivel de tienda y los catálogos de índice PunchOut de nivel 2 tienen campos obligatorios y opcionales.

Los siguientes campos deben proporcionarse pero sólo son obligatorios los campos indicados. Encontrará información adicional en la Guía de referencia sobre el formato de catálogo de Ariba.

Nombre del campo CIF Nivel de tienda Nivel 2 Requisitos de campo

1 Supplier ID X X X Cadena: 255 caracteres

2 Supplier Part ID X X X Cadena: 255 caracteres

3 Manufacturer Part ID Cadena: 255 caracteres

4 Item Description X X X Cadena: 1000 caracteres

5 SPSC Code X X X Cadena: 40 caracteres

6 Unit Price X Decimal

7 Units of Measure X Cadena: 32 caracteres

8 Lead Time Número

9 Manufacturer Name Cadena: 255 caracteres

10 Supplier URL X X Cadena: 255 caracteres

11 Manufacturer URL Cadena: 255 caracteres

12 Market Price Decimal

13 Short Name Cadena: 50 caracteres

14 Image Cadena: 255 caracteres

15 Thumbnail Cadena: 255 caracteres

16 PunchOut Enabled X X Booleano: VERDADERO, FALSO

17 PunchOutLevel X store, aisle, shelf o product

18 Supplier Part Auxiliary ID Cadena: 255 caracteres

19 Parametric Name Cadena: 255 caracteres

20 Parametric Data Cadena: 255 caracteres

Guía de soluciones cXMLTransacciones PunchOut

PUBLICPÚBLICO 121

Page 122: 355a de soluciones cXML - help.sap.com

Requisitos de PunchOut de nivel 2El PunchOut de nivel 2 incluye contenido de índice CIF y cXML y requisitos de sitio.

Requisitos de contenido del índice CIF y cXML [página 122]

Requisitos del sitio PunchOut de nivel 2 [página 122]

Requisitos de contenido del índice CIF y cXML

El contenido del índice CIF y cXML incluye campos tanto obligatorios como opcionales.

Campos obligatorios

● El atributo PunchOutLevel (artículos a nivel de tienda, pasillo, estantería o producto)● Combinación ID de pieza de proveedor único/ID auxiliar de pieza de proveedor (identificador clave para el

artículo de índice seleccionado; los valores están incluidos en el documento PunchOutSetupRequest)● Completa descripción de artículo (nombre de producto para búsqueda, atributos de producto, etc.; para

artículos a nivel de tienda, pasillo y estantería; sólo se muestran los 50 primeros caracteres)● Código UNSPSC (utiliza niveles detallados para artículos a nivel de estantería y de producto)● URL de proveedor (obligatorio para compatibilidad con Ariba Buyer 8.x; una URL ficticia es suficiente)

Información adicional también recomendada:

● Fabricante e ID de pieza de fabricante● Datos paramétricos (si procede)

Campos opcionales

● Short Name (si utiliza este campo, Item Description no se muestra excepto para artículos de nivel de producto)

● Enlace Image (la imagen se muestra como una reseña únicamente para artículos de nivel de producto)● Unit Price o Market Price proporciona un precio estimado únicamente para artículos de nivel de

producto (no se puede utilizar para otros niveles de artículo)

Requisitos del sitio PunchOut de nivel 2

Hay ciertos requisitos mínimos para el sitio PunchOut de nivel 2, así como otros posibles requisitos.

122PUBLICPÚBLICO

Guía de soluciones cXMLTransacciones PunchOut

Page 123: 355a de soluciones cXML - help.sap.com

Requisitos mínimos

● Acceso directo al artículo o a la estantería que se ha especificado en el catálogo de índice● Botón de un clic inmediato Volver a Ariba Buyer para publicar los artículos desde el sitio del proveedor en la

aplicación SAP Ariba● Asistencia para editar PunchOut para permitir al usuario volver a la sesión de compra y modificar la cantidad

de un artículo, eliminar un artículo o agregarlo● Asistencia para inspeccionar PunchOut de modo que los solicitantes y responsables de aprobación puedan ver

el carrito de la compra pero no puedan modificar los artículos que hay en él● Opción para continuar comprando en el sitio PunchOut en lugar de volver inmediatamente con el artículo

seleccionado

En el caso del nivel de estantería, no debería exigirse un mayor ajuste para seleccionar un artículo una vez que el asociado ha alcanzado el sitio. El sitio debería ofrecer una breve lista de artículos de forma inmediata.

Otros requisitos

● Debe poder proporcionar actualizaciones oportunas para el índice PunchOut cuando se produzcan cambios (las actualizaciones dependen en la mayoría de los casos de la frecuencia de los cambios en el índice; la mejor opción es una vez cada trimestre).

● Opcionalmente, puede cargar un índice de PunchOut actualizado en Ariba Network automáticamente mediante la transacción CatalogUploadRequest (consulte el elemento CatalogUploadRequest [página 385] para obtener más información). Esta es una buena forma de reducir la carga de trabajo.

● Debe poder soportar pedidos que llegan al sitio desde múltiples sesiones PunchOut. (La cookie de proveedor almacenada en el método SupplierPartAuxiliaryID, utilizada tradicionalmente para emparejar sesiones PunchOut con pedidos, es más difícil que se soporte con el PunchOut de nivel 2 que con el PunchOut a nivel de sitio).

Ejemplos de catálogos de índice

Puede especificar artículos PunchOut de nivel 2 en catálogos de índice CIF o cXML. Para el archivo más pequeño, cree el catálogo de índice en formato cXML en lugar de CIF. Ambos ejemplos de catálogos de índice están en formato cXML.

Catálogo de índice PunchOut a nivel de tienda [página 124]

Catálogo de índice PunchOut de nivel 2 [página 124]

PunchOutSetupRequest resultante [página 125]

Catálogo de índice PunchOut de nivel 2 [página 126]

Guía de soluciones cXMLTransacciones PunchOut

PUBLICPÚBLICO 123

Page 124: 355a de soluciones cXML - help.sap.com

Catálogo de índice PunchOut a nivel de tiendaEl catálogo de índice de ejemplo que aparece abajo muestra un PunchOut a nivel de tienda con un artículo de PunchOut.

CIF_I_V3.0 LOADMODE: FCODEFORMAT: UNSPSC_V13.5COMMENTS: Store-Level PunchOutSUPPLIERID_DOMAIN: NETWORK_IDITEMCOUNT: 1TIMESTAMP: 2006-02-18 00:00:00FIELDNAMES: Supplier ID, Supplier Part ID, Manufacturer Part ID, Item Description, SPSC Code, Unit Price, Unit of Measure, Lead Time, Manufacturer Name, Supplier URL, Manufacturer URL, Market Price, PunchOut EnabledDATAAN100000123,A2C,C-311F,"ACME Garden Supply",27112000,,,,,,,,t ENDOFDATA

Catálogo de índice PunchOut de nivel 2El catálogo de índice de ejemplo muestra el PunchOut de nivel 2, con descripciones de producto expandidas.

CIF_I_V3.0 LOADMODE: FCODEFORMAT: UNSPSC_V13.5COMMENTS: Level 2 PunchOutSUPPLIERID_DOMAIN: NETWORK_IDITEMCOUNT: 198TIMESTAMP: 2006-02-18 00:00:00 FIELDNAMES: Supplier ID, Supplier Part ID, Manufacturer Part ID, Item Description, SPSC Code, Unit Price, Unit of Measure, Lead Time, Manufacturer Name, Supplier URL, Manufacturer URL, Market Price, PunchOut Enabled, PunchoutLevel, Image DATA AN100000123,A2C,C-311F,"Lawn Maid 4 HP side discharge lawnmower. Briggs and Stratton 4.0 hp engine delivers the power for any property. Side Discharge model with a 22"" Quick Mulch Deck. 6"" rear wheels for easy mowing. For flat terrain.",27112014,,,,,,,,t,product,https://www.acme.com/images/A2C.jpg AN100000123,A3C,C-312F,"Lawn Maid 6 HP self-propelled side discharge lawnmower. Briggs and Stratton 6.0 hp engine delivers the power for any lawn. Side Discharge model with a 24"" Quick Mulch Deck. 6"" rear wheels for easy mowing.",27112014,,,,,,,,t,product,https://www.acme.com/images/A3C.jpg AN100000123,A4C,C-316F,"Lawn Maid Post Hole Digger. Drills down to 4 feet. Chromemolly",27112013,,,,,,,,t,product,https://www.lawnsRUs.com/images/A4C.jpg AN100000123,X7H,52429,"Precision Touch 12-amp Electric Blower. 2-speed blower offers the lightweight airpower you need to blow away debris. Double insulated.",27112701,,,,,,,,t,product,https://www.acme.com/images/X7H.jpg ... ENDOFDATA

El catálogo de índice de PunchOut de nivel 2 proporcionar mucho más contenido. Lista cada artículo PunchOut y las descripciones contienen datos suficientes como para que los usuarios puedan encontrar productos específicos. Cuanto más completas sean sus descripciones más probable será que los usuarios encuentren sus artículos durante la búsqueda.

Cada artículo de índice también puede proporcionar a los solicitantes información suficiente para decidir efectuar el punch-out para ver su página de productos. Por ejemplo, enumera un archivo de imagen del catálogo que

124PUBLICPÚBLICO

Guía de soluciones cXMLTransacciones PunchOut

Page 125: 355a de soluciones cXML - help.sap.com

muestra una foto del producto en Ariba Buyer 8.2.2 o posteriores y SAP Ariba Buying and Invoicing. También utiliza el atributo punchoutLevel para indicar que el artículo es un artículo de PunchOut de nivel de producto en SAP Ariba Buying and Invoicing.

PunchOutSetupRequest resultanteEl documento PunchOutSetupRequest de ejemplo ilustra los resultados de una solicitud de usuario desde un catálogo de índice PunchOut de nivel 2.

Si un usuario selecciona el primer artículo del ejemplo Catálogo de índice PunchOut de nivel 2 [página 124] se genera un documento PunchOutSetupRequest.

<?xml version="1.0"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd"><cXML payloadID="[email protected]" timestamp="2006-03-19T12:57:09-07:00"> <Header> <From> <Credential domain="NetworkID"> <Identity>AN000002792</Identity> </Credential> </From> <To> <Credential domain="NetworkID"> <Identity>AN100000123</Identity> </Credential> </To> <Sender> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]/Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Ariba Buyer 8.2.2</UserAgent> </Sender> </Header> <Request> <PunchOutSetupRequest operation="create"> <BuyerCookie>1J3YVWU9QWMTB</BuyerCookie> <Extrinsic name="CostCenter">610</Extrinsic> <Extrinsic name="User">jpicard</Extrinsic> <BrowserFormPost> <URL>http://bigbuyer.com:3377/punchout</URL> </BrowserFormPost> <SupplierSetup> <URL></URL> </SupplierSetup> <ShipTo> <Address addressID="001"> <Name xml:lang="en">BigBuyer Headquarters</Name> <PostalAddress> <DeliverTo>Jean Picard</DeliverTo> <Street>1565 Pine, MS A.2</Street> <City>New York</City> <State>NY</State> <PostalCode>01043</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> </Address> </ShipTo> <Contact> <Name>jpicard</Name> </Contact>

Guía de soluciones cXMLTransacciones PunchOut

PUBLICPÚBLICO 125

Page 126: 355a de soluciones cXML - help.sap.com

<SelectedItem> <ItemID> <SupplierPartID>A2C</SupplierPartID> </ItemID> </SelectedItem> </PunchOutSetupRequest> </Request> </cXML>

Su sitio PunchOut utiliza el elemento SupplierPartID para determinar qué producto se ha de mostrar. Si necesita diferenciar variaciones de un producto por talla, color o idioma, utilice el campo SupplierPartAuxiliaryID de su catálogo de índice; los sistemas de compras lo copian en el elemento SelectedItem.

Catálogo de índice PunchOut de nivel 2El catálogo de índice PunchOut de nivel 2 de ejemplo ilustra una solicitud de nivel de artículo.

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE Index SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.012/cXML.dtd"> <Index> <SupplierID domain="duns">611429481</SupplierID> <Comments xml:lang="en-US"> Sample cXML/Index </Comments> <IndexItem> <IndexItemPunchout> <ItemID> <SupplierPartID>1-57231-805-8</SupplierPartID> </ItemID> <PunchoutDetail punchoutLevel="product"> <Description xml:lang="en-US">Whiteboard markers, one dozen</Description> <URL>http://www.whitebd.com/cXML/PunchoutSetup/ Punchoutshop.asp</URL> <Classification domain="UNSPSC">55101524</Classification> </PunchoutDetail> </IndexItemPunchout> </IndexItem> <IndexItem> <IndexItemPunchout> <ItemID> <SupplierPartID>VTS-4976-200</SupplierPartID> </ItemID> <PunchoutDetail punchoutLevel="product"> <Description xml:lang="en-US">Whiteboard Eraser, felt</Description> <URL>http://www.whitebd.com/cXML/PunchoutSetup/ Punchoutshop.asp</URL> <Classification domain="UNSPSC">43232005</Classification> </PunchoutDetail> </IndexItemPunchout> </IndexItem> <IndexItem> <IndexItemPunchout> <ItemID> <SupplierPartID>GS3600</SupplierPartID> </ItemID> <PunchoutDetail punchoutLevel="product"> <Description xml:lang="en-US">Whiteboard Cleaner, non-toxic</Description> <URL>http://www.whitebd.com/cXML/PunchoutSetup/ Punchoutshop.asp</URL>

126PUBLICPÚBLICO

Guía de soluciones cXMLTransacciones PunchOut

Page 127: 355a de soluciones cXML - help.sap.com

<Classification domain="UNSPSC">52161512</Classification> </PunchoutDetail> </IndexItemPunchout> </IndexItem> </Index>

PunchOut a nivel de estanteríaEl PunchOut a nivel de estantería es una forma de ofrecer productos similares a través de un artículo de índice PunchOut. Considere utilizar este tipo de PunchOut si tiene productos similares de varios fabricantes o un único producto disponible en múltiples configuraciones.

Cree una página de selección de producto en su sitio PunchOut que permita a los solicitantes elegir una configuración o UDA específica.

Por ejemplo puede ofrecer cortacéspedes de varios fabricantes:

Cortacésped Lawn Maid autopropulsado con motor de gas 4 AP y ancho de corte de 20 pulgadas, descarga lateralCortacésped Lawn Maid autopropulsado con motor de gas 6 AP y ancho de corte de 25 pulgadas, descarga lateralCortacésped Precision Touch con motor de gas 4 AP y ancho de corte de 12 pulgadas, descarga lateralCortacésped Precision Touch con motor de gas 5 AP y ancho de corte de 15 pulgadas, descarga trasera

La página de selección de producto en su sitio PunchOut puede mostrar estos modelos con enlaces a fichas técnicas. Podría agregar el siguiente artículo a su catálogo de índice PunchOut para que los solicitantes encontraran esta categoría de producto y efectuarán el punch-out a su página de selección de producto:

AN100000123,lawnmowers,XXX,"Powerful and Efficient Gas Lawnmowers",27112014,,,,,,,,t,https://www.acme.com/images/lawnmower.jpg,shelf

Cuando los usuarios efectúen el punch-out a su página de selección de producto no tendrán que llevar a cabo una búsqueda para localizar un producto o una configuración específica. En lugar de ello, su página mostrará todos los productos disponibles de ese tipo.

Utilice el PunchOut a nivel de estantería para especificar productos, no grupos de productos relacionados. Por ejemplo:

Proveedor de ejemplo Productos específicos Grupos de productos

Tienda de informática Ratones de ordenador Periféricos

Tienda de equipos Serruchos Herramientas

Tienda de alimentación Cereales Alimentos para el desayuno

Carga de catálogos de índiceEl PunchOut de nivel 2 requiere que cargue sus catálogos de índice en Ariba Network más a menudo que para el PunchOut a nivel de tienda, para garantizar que sus clientes disponen de sus últimas ofertas de productos. En función de la volatilidad de sus ofertas, puede querer actualizar sus catálogos mensualmente, semanalmente o incluso a diario.

Guía de soluciones cXMLTransacciones PunchOut

PUBLICPÚBLICO 127

Page 128: 355a de soluciones cXML - help.sap.com

Cada vez que carga un catálogo, el sistema de compras de su cliente lo descarga automáticamente y lo incorpora al índice de búsqueda local.

NotacXML es el formato preferido para los catálogos de índice de PunchOut de nivel 2 porque el tamaño del archivo es menor que en CIF.

Tiene dos opciones para cargar catálogos:

● Carga manual: La carga manual requiere que inicie sesión en su cuenta de Ariba Network para cargar y publicar sus catálogos de índice cXML. Si desea obtener más información sobre la carga manual de catálogos, consulte Creación y gestión de catálogos.

● Carga automática: La carga automática utiliza la transacción cXML CatalogUpload para cargar y publicar sus catálogos de índice cXML. Genere un documento CatalogUploadRequest e incluya su catálogo cXML como un adjunto MIME. Si desea obtener más información sobre la carga automática, consulte Transacción de carga de catálogo [página 382].

Sus clientes consultarán automáticamente en Ariba Network los catálogos cargados, generalmente una vez al día. Es posible que quiera ponerse en contacto con ellos para averiguar a qué hora tiene lugar esa consulta con el fin de poder tener preparados sus catálogos de índice actualizados.

Tiempo límite para sesiones PunchOutSi las sesiones de PunchOut no finalizan con un documento PunchOutOrderMessage, Ariba Buyer y SAP Ariba Buying and Invoicing finalizarán la sesión al cabo de seis horas.

Ejemplos ASPLos ejemplos ASP pueden utilizarse como punto de partida para desplegar un sitio PunchOut rápidamente. Muestran cómo recibir documentos PunchOutSetupRequest y generar documentos PunchOutSetupResponse.

Se trata de ejemplos básicos y no son aptos para producción. Las variables de credencial adjuntadas a la cadena de consulta por ejemplo no son aceptables para el código de producción. Estos ejemplos utilizan variables que no se han declarado. Dado que con este ejemplo no se ha incluido un archivo de variable global, cambie las siguientes variables en las ubicaciones apropiadas:

● receivePunchoutSetupRequest.asp

myAribaPassword = "welcome" myURL = http://supersupplier.com/punchoutasp

● resolveXML.asp

olddtdvalue = """cXML.dtd""" newdtdvalue = """http://supersupplier.com/cXML.dtd"""

128PUBLICPÚBLICO

Guía de soluciones cXMLTransacciones PunchOut

Page 129: 355a de soluciones cXML - help.sap.com

receivePunchoutSetupRequest.asp

El ejemplo receivePunchoutSetupRequest.asp en el que se recibe el documento PunchOutSetupRequest y se genera un documento PunchOutSetupResponse válido que contiene la URL de la primera página.

<%@LANGUAGE = VBScript%> <% Dim myAribaPassword Dim myURL%><%'********************************Comments****************************' Include file that loads http post cXML and parses with MS DOM'********************************************************************%><!--#include file="resolveXML.asp" ---><%'********************************Comments****************************' Variables needed for example. Very simple validation for asp' Set sharedsecret password expected from Ariba Network'******************************************************************** myAribaPassword = "welcome" myURL = "http://workchairs.com/punchoutaspv2/"%><%'********************************Comments****************************' Basic Shared Secret validation.'' Please note: You will need to fix the timestamp and payloadID. The' f() now is currently invalid and will fail on some builds of Ariba' Buyer as well as other product lines. Please use the format' specified in the cXML reference guide available at http://www.cXML.org.' See file TCcXMLFormatDTime.asp for a good start on formatting the' timestamp in ISO 8601 format.'********************************************************************if (myAribaPassword <> sharedSecret) then %><?xml version="1.0" ?><!DOCTYPE cXML SYSTEM "cXML.dtd"><cXML payloadID="&lt;%= Now &&quot;@&quot;& Request.ServerVariables(&quot;LOCAL_ADDR&quot;)%&gt;" timestamp="&lt;%= Now %&gt;"><Response><Status code="500" Text="Invalid document" /></Response></cXML><% else %><?xml version="1.0" ?><!DOCTYPE cXML SYSTEM "cXML.dtd"><cXML payloadID="&lt;%= Now &&quot;@&quot;& Request.ServerVariables(&quot;LOCAL_ADDR&quot;)%&gt;" timestamp="&lt;%= Now %&gt;"><Response><Status code="200" text="Success"></Status><PunchOutSetupResponse><StartPage><URL><%=myURL%> <p>b2bsite/shop.asp?fromIdentity=<%= fromIdentity%>&operation=<%= operation%>&buyerCookie=<%= buyerCookie%>&BrowserFormPost=<%= BrowserFormPost%></URL></StartPage></PunchOutSetupResponse></Response></cXML> <%end if%> </p>

Guía de soluciones cXMLTransacciones PunchOut

PUBLICPÚBLICO 129

Page 130: 355a de soluciones cXML - help.sap.com

resolveXML.asp

El archivo de ejemplo resolveXML.asp carga el HTTP POST en un objeto Microsoft DOM y extrae datos para el documento PunchOutSetupResponse.

<% Dim xmlDim xdocDim xml2'********************************Comments****************************' MSDOM cannot resolve local DTDs, so replace definition with URL.' Get DTDs from http://www.cXML.org and store them locally on your' server for performance.'********************************************************************Dim olddtdvalueDim newdtdvalueolddtdvalue = """cXML.dtd"""newdtdvalue = """http://workchairs.com/cxml1.2/cXML.dtd"""if (Request.ServerVariables("REQUEST_METHOD") = "POST") then'********************************Comments****************************' This command reads the incoming HTTP cXML Request' Note: this does not currently handle cXML documents sent with' content-type: text/xml or any transfer that specifies the MIME' charset attribute on that header.'******************************************************************** totalBytes = Request.TotalBytes IF totalBytes > 0 THEN xml = Request.BinaryRead( totalBytes ) for i = 1 to totalBytes xmlstr = xmlstr + String(1,AscB(MidB(xml, i, 1))) Next xml2 = xmlstr xml2 = Replace(xml2,olddtdvalue,newdtdvalue) xml2 = Replace(xml2,"utf-8","utf-16") xml2 = Replace(xml2,"UTF-8","UTF-16") END IF'********************************Comments****************************' Create MSDOM object and set load values.'********************************************************************Set xdoc = Server.CreateObject("Microsoft.XMLDOM") xdoc.ValidateOnParse = False xdoc.async = False xdoc.resolveExternals = False loadStatus = xdoc.loadXML(xml2)'********************************Comments****************************' Create MSDOM object and set load values.' Note: these XML retrievals handle only the first of any list of' credential elements'******************************************************************** If loadStatus = True then Set fromIdentity = xdoc.getElementsByTagName("Header/From/Credential/Identity") fromIdentity = (fromIdentity.item(0).text) Set toSuppCred = xdoc.getElementsByTagName("Header/To/Credential/Identity") toSuppCred = (toSuppCred.item(0).text) Set senderCred = xdoc.getElementsByTagName("Header/Sender/Credential/Identity") senderCred = (senderCred.item(0).text) Set sharedSecret = xdoc.getElementsByTagName("Header/Sender/Credential/SharedSecret") sharedSecret = (sharedSecret.item(0).text) Set fromUserAgent = xdoc.getElementsByTagName("Header/Sender/UserAgent") fromUserAge = (fromUserAgent.item(0).text) Set operation = xdoc.documentElement.childNodes(1).childNodes(0).attributes.getNamedItem("operation")

130PUBLICPÚBLICO

Guía de soluciones cXMLTransacciones PunchOut

Page 131: 355a de soluciones cXML - help.sap.com

operation = xdoc.documentElement.childNodes(1).childNodes(0).attributes.getNamedItem("operation").text Set buyerCookie = xdoc.getElementsByTagName("Request/PunchOutSetupRequest/BuyerCookie") buyerCookie = (buyerCookie.item(0).text) Set buyExtrinsics = xdoc.getElementsByTagName("Request/PunchOutSetupRequest/Extrinsic") For i = 0 To (buyExtrinsics.length -1) BuyExtrinsicVars = (buyExtrinsics.item(i).text) & "," & BuyExtrinsicVars Next Set BrowserFormPost = xdoc.getElementsByTagName("Request/PunchOutSetupRequest/BrowserFormPost") BrowserFormPost = (BrowserFormPost.item(0).text)'********************************Comments****************************' Some nice MSDOM error logging for a failed parse or load.'******************************************************************** Else Response.Write " <P> xml @ supplier site failed to load using MSDOM: " Dim strErrText Dim xPE Set xPE = xdoc.parseError strErrText = "Your XML Document failed to load due the following error: " & "Error #: " & xPE.errorCode & ": " & "Line #: " & xPE.Line & "Line Position: " & xPE.linepos & "Position In File: " & xPE.filepos & "Source Text: " & xPE.srcText & "Document URL: " & xPE.url Response.Write strErrText End If Else'********************************Comments****************************' ASP page was called using a GET. Functions expect a post.'******************************************************************** Response.Write "<P> Wrong Method Get: Post supported only"End if %>

TCcXMLFormatDTime.asp

El archivo TCcXMLFormatFDTime contiene una función para formatear una marca de tiempo en formato ISO 8601.

'******************************************************************** ' This function does not do the time adjustment but provides a great' start in helping you out.'********************************************************************<%private function TCcXMLFormatDTime(strDTimeIn)'********************************************************************' Purpose:' This function returns a date/time value formatted for cXML messaging' cXML uses the ISO 8601 date/time standard.'********************************************************************'Input: 'strDTimeIn Input date/time to be formatted.''Ouptut: n/a''Return: String value containing the formatted date/time.' const conRoutine = "TCcXMLFormatDTime" dim strTempOutDtime dim strDay dim strMonth dim strTime

Guía de soluciones cXMLTransacciones PunchOut

PUBLICPÚBLICO 131

Page 132: 355a de soluciones cXML - help.sap.com

TCcXMLFormatDTime = "" strTime = FormatDateTime(strDTimeIn, 4) ' Short time. ' Set the year. strTempOutDtime = Year(strDTimeIn) & "-" ' Set the month. strMonth = Month(strDTimeIn) if len(strMonth) = 1 then strMonth = "0" & strMonth strTempOutDtime = strTempOutDtime & strMonth & "-" ' Set the day and the date/time delimeter. strDay = Day(strDTimeIn) if len(strDay) = 1 then strDay = "0" & strDay strTempOutDtime = strTempOutDtime & strDay & "T" ' Set the time. strTempOutDtime = strTempOutDtime & strTime TCcXMLFormatDTime = strTempOutDtime exit functionend function%> </p></body> </html>

132PUBLICPÚBLICO

Guía de soluciones cXMLTransacciones PunchOut

Page 133: 355a de soluciones cXML - help.sap.com

Adjuntos

El protocolo cXML admite adjuntar archivos externos de cualquier tipo a los documentos cXML, incluyendo los pedidos, las confirmaciones de pedido, los avisos de expedición, las hojas de servicio y los catálogos. El documento cXML contiene referencias a partes externas enviadas dentro de un sobre MIME de varias partes.

Los compradores utilizan notas o dibujos para aclarar pedidos a veces. De forma similar, los proveedores a veces aclaran la confirmación de pedido, los avisos de expedición, las hojas de servicio y las facturas con notas, faxes o dibujos.

Referencias adicionales

● Guía de referencia de cXML en este manual http://www.cxml.org● Tamaño máximo de documentos y adjuntos [página 22]

Adjuntos en Ariba Network [página 133]

Nombres de archivo para adjuntos [página 134]

Adjuntos y escaneo antivirus [página 134]

Extrínseco AttachmentOnline [página 134]

Adjuntos en Ariba NetworkAriba Network almacena adjuntos que pueden ser recuperados por ambos socios comerciales. Los usuarios pueden recuperar esos archivos accediendo a sus cuentas Ariba Network. Ariba Network también puede reenviar adjuntos a proveedores a través del correo electrónico o de comunicaciones cXML.

Los adjuntos vencen 18 meses después de que Ariba Network los reciba. Los adjuntos vencidos no están disponibles en línea.

Ariba Network tiene los siguientes detalles de la implementación de adjunto:

● En la parte del adjunto del archivo MIME, la longitud del contenido es opcional, pero es obligatorio indicar la disposición del contenido junto con el nombre del adjunto.

● En la parte del adjunto del archivo MIME, si se utilizan caracteres no ASCII en el nombre del archivo de la cabecera Disposición de contenido, el documento adjuntado describe el método de codificación utilizado por Ariba Network.

● En la parte cXML del archivo MIME, la etiqueta del adjunto es opcional para pedidos con adjuntos. Si las etiquetas de adjunto en la cabecera o en el artículo en línea están realmente provistas de los correspondientes ID de contenido de los adjuntos, Ariba Network conserva los ID de contenido del adjunto en el archivo MIME enviado al proveedor. Un proveedor habilitado para cXML puede utilizar las etiquetas de adjunto para vincular los adjuntos a los correspondientes artículos en línea.

Guía de soluciones cXMLAdjuntos

PUBLICPÚBLICO 133

Page 134: 355a de soluciones cXML - help.sap.com

● En la cabecera POST principal del archivo MIME, el tipo de contenido puede ser una cabecera de varias partes/relacionada o de varias partes/mixta.

● Ariba Network no es compatible con el atributo Attachment@visibility actualmente, aunque está definido en la DTD cXML.

Nombres de archivo para adjuntosAriba Network soporta adjuntos con nombres de archivo en todos los conjuntos de caracteres soportados, incluidos el chino, el japonés y el coreano.

Ariba Network cumple las convenciones Multipurpose Internet Mail Extensions (MIME) al codificar los nombres de archivo no ASCII de acuerdo con la Request for Comment (RFC) 2047 de Internet Engineer Task Force (IETF). Los nombres de archivo en idiomas asiáticos pueden tener un máximo de 15 caracteres y en idiomas con alfabeto latino n.º 1, hasta 21 caracteres de 8 bites o 70 caracteres de siete bits.

Adjuntos y escaneo antivirusSAP Ariba explora automáticamente los archivos externos que se cargan a Ariba Network.

Si se detecta un virus o malware cuando se carga un archivo, SAP Ariba muestra un mensaje de advertencia que indica que el archivo está infectado. Se analizan los archivos cargados en busca de virus con el streaming del contenido del archivo para el motor de análisis de virus, por lo tanto, no se guarda ninguna copia local del archivo antes de analizar. Si se detecta un virus, el archivo automáticamente se depura del sistema.

Extrínseco AttachmentOnlineEl extrínseco AttachmentOnline indica que una cuenta está configurada para enviar documentos cXML pero no adjuntos. Pueden utilizarlo los compradores y los proveedores en función de sus configuraciones.

Dejar anexos en línea para los pedidos

Si los proveedores configuran sus cuentas Ariba Network para enviar pedidos pero no adjuntos, Ariba Network agrega un elemento Extrinsic llamado AttachmentOnline a la OrderRequestHeader para indicar que hay adjuntos.

Ejemplo

<Extrinsic name="AttachmentOnline"> https://service.ariba.com/ad/orderDetail?poID=1234&amp;anp=Ariba

134PUBLICPÚBLICO

Guía de soluciones cXMLAdjuntos

Page 135: 355a de soluciones cXML - help.sap.com

</Extrinsic>

Los proveedores pueden utilizar la URL en este Extrinsic para iniciar sesión manualmente y ver el pedido de compra. Después pueden hacer clic en los adjuntos listados para verlos o descargarlos.

NotaAriba Network inserta caracteres del signo & omitidos en la URL. Antes de poder utilizar la URL para iniciar sesión y visualizar el pedido de compra, sustituya «&amp;» por «&» en la URL.

Ariba Network agrega este Extrinsic sólo para proveedores que han seleccionado Dejar adjuntos en línea... en su configuración de enrutamiento de pedidos.

Dejar los adjuntos en línea para las confirmaciones de pedido, los avisos de expedición, las hojas de entrada de servicios y las facturas

Si las organizaciones compradoras configuran sus cuentas Ariba Network para enviar documentos de proveedor pero no adjuntos, Ariba Network agrega un elemento Extrinsic llamado AttachmentOnline a la cabecera para indicar que hay un adjunto.

Ejemplo

<Extrinsic name="AttachmentOnline"> https://service.ariba.com/ad/shipnoticeDetail?poID=1234&anp=Ariba </Extrinsic>

Las organizaciones compradoras pueden utilizar la URL en este Extrinsic para iniciar sesión manualmente y ver el documento. Después pueden hacer clic en los adjuntos listados para verlos o descargarlos.

Ariba Network agrega este Extrinsic sólo para las organizaciones compradoras que han seleccionado Enviar URL para ver adjuntos en Ariba Network en su configuración de transacción.

Guía de soluciones cXMLAdjuntos

PUBLICPÚBLICO 135

Page 136: 355a de soluciones cXML - help.sap.com

Solicitudes de compra

Una solicitud de compra es el primer paso de un proceso de compra.

Una solicitud de compra es una petición para comprar uno o varios artículos. A cada solicitud se asigna un ID único (como, por ejemplo, PR2394) para realizar su seguimiento a medida que se desplaza por el proceso de compra. Una solicitud puede constar de varios artículos de línea.

Envía documentos de solicitudes de compra en el formato cXML a la solución Ariba Procurement mediante Ariba Network. Después de procesar la solicitud de compra en un pedido, el pedido de compra se envía al proveedor adecuado mediante Ariba Network.

Una solicitud puede contener artículos de cualquiera de las siguientes fuentes:

● El catálogo de la empresa del solicitante● Un catálogo del proveedor (también conocido como el catálogo de PunchOut)● Artículos por encargo (de otro origen)

Importación de solicitudes de compra [página 136]

Importación de una nueva solicitud de compra [página 136]

Actualización de una solicitud de compra [página 139]

Cancelación de una solicitud de compra [página 140]

Importación de solicitudes de compraAntes de poder importar solicitudes de compra utilizando las comunicaciones cXML, asegúrese que su sitio está configurado para utilizar XML para la integración de datos. El canal cXML solo se aplica a Ariba Network y no de ERP a Soluciones de SAP Ariba Procurement.

Se requieren los siguientes cuatro campos extrínsecos en el archivo cXML PurchaseRequisitionRequest:

● AccountCategory● BuyerPartNumber● Facility● Need-by Date

Importación de una nueva solicitud de compraEl siguiente ejemplo importa una nueva solicitud de compra:

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.026/cXML.dtd">

136PUBLICPÚBLICO

Guía de soluciones cXMLSolicitudes de compra

Page 137: 355a de soluciones cXML - help.sap.com

<cXML payloadID="req00001" timestamp="2016-05-26T00:00:00-08:00" xml:lang="en-US"> <Header> <From> <!-- Ariba Network buyer account --> <Credential domain="NetworkID"> <Identity>AN71000002012</Identity> </Credential> <Credential domain="EndPointID"> <Identity>ERP</Identity> </Credential> </From> <To> <!-- Ariba Network buyer account --> <Credential domain="NetworkID"> <Identity>AN71000002012</Identity> </Credential> <Credential domain="EndPointID"> <Identity>ERP</Identity> </Credential> </To> <Sender> <!-- This document has passed from the ERP to the SAP Ariba Procurement Solution. --> <Credential domain="NetworkID"> <Identity>AN71000002012</Identity> </Credential> <Credential domain="EndPointID"> <Identity>ERP</Identity> <SharedSecret>welcome3a</SharedSecret> </Credential> <UserAgent>Ariba.com Network V1.0</UserAgent> </Sender> </Header> <Request> <PurchaseRequisitionRequest> <PurchaseRequisition> <PurchaseRequisitionHeader requisitionID="PR123" requisitionDate="2016-05-26T00:00:00-08:00" type="new"> <ShipTo> <Address addressID="3000"> <Name xml:lang="en">New York</Name> <PostalAddress> <DeliverTo>Joe Smith</DeliverTo> <Street>691 Random Ave</Street> <City>New York</City> <State>NY</State> <PostalCode>10001</PostalCode> <Country isoCountryCode="US">USA</Country> </PostalAddress> </Address> </ShipTo> <BillTo> <Address addressID="US006"> <Name xml:lang="en">New York</Name> <PostalAddress> <Street>691 Random Ave</Street> <City>New York</City> <State>NY</State> <PostalCode>10001</PostalCode> <Country isoCountryCode="US">USA</Country> </PostalAddress> </Address> </BillTo> <Contact role="preparer"> <Name xml:lang="en-US">Jane Doe</Name>

Guía de soluciones cXMLSolicitudes de compra

PUBLICPÚBLICO 137

Page 138: 355a de soluciones cXML - help.sap.com

<PostalAddress> <Street>123 Anystreet</Street> <City>Sunnyvale</City> <State>CA</State> <PostalCode>94089</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> <Email>[email protected]</Email> </Contact> <Contact role="requester"> <Name xml:lang="en-US">Jane Doe</Name> <PostalAddress> <Street>123 Anystreet</Street> <City>Sunnyvale</City> <State>CA</State> <PostalCode>94089</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> <Email>[email protected]</Email> </Contact> </PurchaseRequisitionHeader> <ItemIn quantity="10.000" lineNumber="00001"> <ItemID> <SupplierPartID>MON923 6</SupplierPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">100.00</Money> </UnitPrice> <Description xml:lang="en">Optimax-V Monitor Cable DB9M/DB23F </Description> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="UNSPSC">43211800</Classification> <Extrinsic name="AccountCategory">K</Extrinsic> <Extrinsic name="PurchaseOrg">3000</Extrinsic> <Extrinsic name="PurchaseGroup">100</Extrinsic> <Extrinsic name="BuyerPartNumber">SSP16446-cXML</Extrinsic> <Extrinsic name="Facility">Bangalore</Extrinsic> <Extrinsic name="Need-by Date">2016-06-10T00:00:00-08:00</Extrinsic> </ItemDetail> <SupplierList> <Supplier> <Name xml:lang="en">JCN Technologies</Name> <SupplierID domain="NetworkID">AN70000000004</SupplierID> </Supplier> </SupplierList> <Distribution> <Accounting name="Default"> <AccountingSegment id="100"> <Name xml:lang="en">Percentage</Name> <Description xml:lang="en">Percentage</Description> </AccountingSegment> <AccountingSegment id="02"> <Name xml:lang="en">Company</Name> <Description xml:lang="en">ID</Description> </AccountingSegment> <AccountingSegment id="5000"> <Name xml:lang="en">CostCenter</Name> <Description xml:lang="en">ID</Description> </AccountingSegment> <AccountingSegment id="US002"> <Name xml:lang="en">BusinessUnit</Name> <Description xml:lang="en">ID</Description> </AccountingSegment> <AccountingSegment id="8100"> <Name xml:lang="en">Account</Name> <Description xml:lang="en">ID</Description> </AccountingSegment>

138PUBLICPÚBLICO

Guía de soluciones cXMLSolicitudes de compra

Page 139: 355a de soluciones cXML - help.sap.com

<AccountingSegment id="5009"> <Name xml:lang="en">SubAccount</Name> <Description xml:lang="en">ID</Description> </AccountingSegment> </Accounting> <Charge> <Money currency="USD">20000.00</Money> </Charge> </Distribution> </ItemIn> </PurchaseRequisition> </PurchaseRequisitionRequest> </Request> </cXML>

Actualización de una solicitud de compraEl siguiente ejemplo actualiza una solicitud de compra existente:

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.026/cXML.dtd"><cXML payloadID="req00002" timestamp="2016-05-27T00:00:00-08:00" xml:lang="en-US"> <Header> <From> <!-- Ariba Network buyer account --> <Credential domain="NetworkID"> <Identity>AN71000002012</Identity> </Credential> <Credential domain="EndPointID"> <Identity>ERP</Identity> </Credential> </From> <To> <!-- Ariba Network buyer account --> <Credential domain="NetworkID"> <Identity>AN71000002012</Identity> </Credential> <Credential domain="EndPointID"> <Identity>ERP</Identity> </Credential> </To> <Sender> <!-- This document has passed from the ERP to the SAP Ariba Procurement Solution. --> <Credential domain="NetworkID"> <Identity>AN71000002012</Identity> </Credential> <Credential domain="EndPointID"> <Identity>ERP</Identity> <SharedSecret>welcome3a</SharedSecret> </Credential> <UserAgent>Ariba.com Network V1.0</UserAgent> </Sender> </Header> <Request> <PurchaseRequisitionRequest> <PurchaseRequisition> <PurchaseRequisitionHeader requisitionID="PR123" requisitionDate="2016-05-26T00:00:00-08:00" type="update">

Guía de soluciones cXMLSolicitudes de compra

PUBLICPÚBLICO 139

Page 140: 355a de soluciones cXML - help.sap.com

... </PurchaseRequisitionHeader> <ItemIn> <ItemID> <SupplierPartID>MON923 6</SupplierPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">100.00</Money> </UnitPrice> <Description xml:lang="en">Optimax-V Monitor Cable DB9M/DB23F </Description> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="UNSPSC">43211800</Classification> <Extrinsic name="AccountCategory">K</Extrinsic> <Extrinsic name="PurchaseOrg">3000</Extrinsic> <Extrinsic name="PurchaseGroup">100</Extrinsic> <Extrinsic name="BuyerPartNumber">SSP16446-cXML</Extrinsic> <Extrinsic name="Facility">Bangalore</Extrinsic> <Extrinsic name="Need-by Date">2016-06-10T00:00:00-08:00</Extrinsic> </ItemDetail> </ItemIn> ... </PurchaseRequisition> </PurchaseRequisitionRequest> </Request> </cXML>

Cancelación de una solicitud de compraEl siguiente ejemplo cancela una solicitud de compra existente:

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.026/cXML.dtd"><cXML payloadID="req00002" timestamp="2016-05-27T00:00:00-08:00" xml:lang="en-US"> <Header> <From> <!-- Ariba Network buyer account --> <Credential domain="NetworkID"> <Identity>AN71000002012</Identity> </Credential> <Credential domain="EndPointID"> <Identity>ERP</Identity> </Credential> </From> <To> <!-- Ariba Network buyer account --> <Credential domain="NetworkID"> <Identity>AN71000002012</Identity> </Credential> <Credential domain="EndPointID"> <Identity>ERP</Identity> </Credential> </To> <Sender> <!-- This document has passed from the ERP to the Ariba Procurement Solution. --> <Credential domain="NetworkID"> <Identity>AN71000002012</Identity> </Credential> <Credential domain="EndPointID">

140PUBLICPÚBLICO

Guía de soluciones cXMLSolicitudes de compra

Page 141: 355a de soluciones cXML - help.sap.com

<Identity>ERP</Identity> <SharedSecret>welcome3a</SharedSecret> </Credential> <UserAgent>Ariba.com Network V1.0</UserAgent> </Sender> </Header> <Request> <PurchaseRequisitionRequest> <PurchaseRequisition> <PurchaseRequisitionHeader requisitionID="PR123" requisitionDate="2016-05-26T00:00:00-08:00" type="delete"> ... </PurchaseRequisitionHeader> <ItemIn> <ItemID> <SupplierPartID>MON923 6</SupplierPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">100.00</Money> </UnitPrice> <Description xml:lang="en">Optimax-V Monitor Cable DB9M/DB23F </Description> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="UNSPSC">43211800</Classification> <Extrinsic name="AccountCategory">K</Extrinsic> <Extrinsic name="PurchaseOrg">3000</Extrinsic> <Extrinsic name="PurchaseGroup">100</Extrinsic> <Extrinsic name="BuyerPartNumber">SSP16446-cXML</Extrinsic> <Extrinsic name="Facility">Bangalore</Extrinsic> <Extrinsic name="Need-by Date">2016-06-10T00:00:00-08:00</Extrinsic> </ItemDetail> </ItemIn> ... </PurchaseRequisition> </PurchaseRequisitionRequest> </Request> </cXML>

Guía de soluciones cXMLSolicitudes de compra

PUBLICPÚBLICO 141

Page 142: 355a de soluciones cXML - help.sap.com

Pedidos de compra

Los documentos cXML OrderRequest representan pedidos de compra. Estos documentos están formados por un elemento OrderRequestHeader y uno o más elementos ItemOut. Ariba Buyer y SAP Ariba Buying and Invoicing envían estos documentos a Ariba Network. Los proveedores habilitados para cXML responden con documentos OrderResponse.

Enrutamiento del pedido en Ariba Network [página 142]

Elemento OrderRequestHeader [página 143]

Elemento ItemOut [página 168]

Valores de enmascaramiento en pedidos de compra [página 173]

Pedidos de cancelación y pedidos de cambio [página 182]

Pedidos de cambio [página 185]

Consejos de implementación y restricciones para pedidos de compra [página 186]

Órdenes de entrega basadas en plan de entrega [página 202]

Artículos en línea de servicio planificada y sin planificar [página 205]

Documentos de respuesta [página 219]

Enrutamiento del pedido en Ariba NetworkLos proveedores de Ariba Network pueden seleccionar métodos de enrutamiento electrónico para pedidos y otros documentos entrantes.

Los pedidos se generan desde apilcaciones de compras de cliente y se envían en formato electrónico a Ariba Network como documentos cXML.

Ariba Network esencialmente funciona como un hub para recibir pedidos y enrutarlos a proveedores para la revisión y el procesamiento del pedido (cumplimiento) mediante un método de enrutamiento de pedidos permitido. Los proveedores pueden seleccionar métodos de enrutamiento de pedidos cuando configuran su cuenta y luego pueden cambiarlos cuando lo deseen.

El enrutamiento de pedidos en línea es la opción predeterminada. Con el enrutamiento de pedidos en línea, los pedidos aparecen en línea en el portal de proveedor de Ariba Network. El enrutamiento de pedidos en línea tan solo requiere una conexión a Internet y un navegador compatible.

Los proveedores pueden conectarse a Ariba Network con una aplicación habilitada para cXML, por ejemplo un sistema receptor de pedidos, seleccionando cXML como método de enrutamiento. Para obtener información acerca de la configuración del enrutamiento de documentos para su cuenta, consulte Configuración del enrutamiento del documento en el centro de ayuda de SAP Ariba

Los proveedores no necesitan un sitio Web de PunchOut para recibir pedidos de compra cXML. El PunchOut y la recepción de pedidos cXML son capacidades distintas. Sin embargo, la infraestructura y las aplicaciones necesarias compatibles con PunchOut son las mismas que para recibir pedidos de compra cXML.

142PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 143: 355a de soluciones cXML - help.sap.com

Elemento OrderRequestHeader

El elemento OrderRequestHeader contiene información de contacto y de expedición que se aplica a todo el pedido.

OrderRequestHeader tiene los siguientes atributos:

Atributo Descripción

orderID(obligatorio)

El identificador de este pedido. Análogo al número de pedido de compra.

orderDate(obligatorio)

La fecha y hora en que se hizo este pedido (en formato ISO 8601).

orderType Tipo de pedido Valores posibles:

● regular (valor predeterminado): pedido de compra ordinario.● release: orden de entrega para un acuerdo maestro, contrato o pe­

dido de compra global existente.● blanket: pedido de compra global.● stockTransport: pedido de transporte de stock.● stockTransportRelease: versión del plan de entrega de trans­

porte de stock (SAR).

releaseRequired Solo se utiliza si orderType es blanket para indicar si el pedido de compra global requiere órdenes de entrega (pedidos de compra). Si se especifica "sí", el pedido de compra global requiere pedidos preferentes separados an­tes de que el proveedor pueda actuar. Si no se especifica, el proveedor puede actuar en el pedido de compra global en sí. El valor predeterminado es ningún valor especificado.

type Tipo de solicitud: new (predeterminado), update o delete. Las órdenes "update" y "delete" deben utilizar el elemento DocumentReference con payloadID para hacer referencia al pedido de compra original.

orderVersion Especifica el número de la versión de los pedidos de cambio, empezando por "1" para el pedido original.

isInternalVersion Indica si el pedido incluye cambios que solo son relevantes dentro de la or­ganización compradora. Por ejemplo si se ha efectuado un pequeño cambio que no afecta a la información utilizada por el proveedor. Puede que los pro­veedores no vean versiones de pedido internas en función de su configura­ción como clientes.

agreementID Solo se utiliza si orderType es release para indicar el identificador del comprador para un acuerdo maestro o pedido de compra global asociado.

agreementPayloadID Solo se utiliza si orderType es release para indicar el ID de carga útil del documento cXML para el acuerdo maestro o pedido de compra global asociado.

parentAgreementID Solo se utiliza si orderType es blanket para indicar el pedido de com­pra global principal.

parentAgreementPayloadID Solo se utiliza si orderType es blanket para indicar el identificador de referencia de documento del pedido de compra global principal.

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 143

Page 144: 355a de soluciones cXML - help.sap.com

Atributo Descripción

effectiveDate Es obligatorio si orderType es blanket para indicar la fecha de entrada en vigor del pedido de compra global (fecha a partir de la que se pueden crear órdenes de entrega o facturas enviadas para el pedido de compra glo­bal).

expirationDate Solo se utiliza si orderType es blanket para indicar la fecha de expira­ción del pedido de compra global. Las órdenes de entrega no se pueden crear respecto al pedido de compra global después de esta fecha.

requisitionID Identificador de solicitud del comprador para todo este pedido. Podría coin­cidir con orderID y podría no estar incluido en absoluto. No se debe incluir si se especifica requisitionID en cualquier elemento ItemOut.

shipComplete Preferencia respecto a envíos parciales. El único valor permitido es "sí". De forma predeterminada, los artículos se envían cuando están disponibles.

Dado que los pedidos podrían incluir artículos con distintos elementos ShipTo, solo deben retenerse los grupos de artículos con ubicaciones de envío comunes hasta que se complete si shipComplete=“yes”.

pickUpDate Fecha en la que el pedido debe estar listo para su recogida y entrega.

requestedDeliveryDate Información esencial de la fecha tanto para el proveedor como para el trans­portista. En muchos casos refleja el tiempo, o el período de tiempo, en el que el comprador puede y quiere recibir las mercancías.

isSTOOutbound Se establece en yes para indicar que esta OrderRequest se utiliza para enviar el stock al proveedor. Las mercancías se envían del centro del com­prador al centro del proveedor. Actualmente es pertinente solo para el esce­nario de pedido de transporte de stock.

Ejemplo: Pedido de transporte de stock de salida

<OrderRequest> <OrderRequestHeader orderID = "4500030514" orderDate = "2019-03-13T12:00:00+01:00" orderType = "stockTransport" type = "new" orderVersion = "1" isSTOOutbound = "yes"> <Total> <Money currency = "EUR">500.0</Money> </Total> <ShipTo> <Address isoCountryCode = "DE" addressID = "0001" addressIDDomain = "buyerLocationID"> <Name xml:lang = "en">Werk 0001</Name> <PostalAddress name = "default"> <Street>Hasso-Plattner-Ring 7</Street> <City>Walldorf</City> <PostalCode>69190</PostalCode> <Country isoCountryCode = "DE"/> </PostalAddress> </Address>

144PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 145: 355a de soluciones cXML - help.sap.com

<IdReference identifier = "0001" domain = "buyerLocationID"/> </ShipTo> <BillTo> <Address isoCountryCode = "DE" addressID = "CUST_0123" addressIDDomain = "supplierID"> <Name xml:lang = "de">SAP A.G.</Name> <PostalAddress name = "SAP AG"> <Street>Hasso-Plattner-Ring 7</Street> <City>Walldorf</City> <PostalCode>69190</PostalCode> <Country isoCountryCode = "DE"/> </PostalAddress> </Address> <IdReference identifier = "CUST_0123" domain = "supplierID"/> <IdReference identifier = "0001" domain = "buyerID"/> </BillTo> <LegalEntity> <IdReference identifier = "0001" domain = "CompanyCode"> <Description xml:lang = "en">SAP A.G.</Description> </IdReference> </LegalEntity> <OrganizationalUnit> <IdReference identifier = "0001" domain = "PurchasingOrganization"> <Description xml:lang = "en">Einkaufsorg. 0001</Description> </IdReference> </OrganizationalUnit> <PaymentTerm payInNumberOfDays = "14"> <Discount> <DiscountPercent percent = "3.000"/> </Discount> </PaymentTerm> <PaymentTerm payInNumberOfDays = "20"> <Discount> <DiscountPercent percent = "2.000"/> </Discount> </PaymentTerm> <PaymentTerm payInNumberOfDays = "30"> <Discount> <DiscountPercent percent = "0.00"/> </Discount> </PaymentTerm> <Contact role = "supplierCorporate" addressID = "100000" addressIDDomain = "buyerID"> <Name xml:lang = "en">Großhändler THEURER</Name> <PostalAddress> <Street>Wasserturm Straße 121</Street> <City>Mannheim</City> <PostalCode>68059</PostalCode> <Country isoCountryCode = "DE"/> </PostalAddress> <Email name = "default">[email protected]</Email> <IdReference identifier = "100000" domain = "buyerID"/> </Contact> <TermsOfDelivery> <TermsOfDeliveryCode value = "TransportCondition"/> <ShippingPaymentMethod value = "Other"/> <TransportTerms value = "EXW">Ex Works</TransportTerms> <Address> <Name xml:lang = "en">Walldoof</Name> </Address> </TermsOfDelivery>

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 145

Page 146: 355a de soluciones cXML - help.sap.com

<OrderRequestHeaderIndustry> <ExternalDocumentType documentType = "NB"> <Description xml:lang = "en">Standard PO</Description> </ExternalDocumentType> </OrderRequestHeaderIndustry> </OrderRequestHeader> <ItemOut quantity = "10.0" lineNumber = "10" requestedDeliveryDate = "2019-03-15T12:00:00+01:00" itemCategory = "stockTransfer" stockTransferType = "intra" partialDelivery = "yes" orderCombination = "yes" > <ItemID> <SupplierPartID/> <BuyerPartID>STANDARD</BuyerPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency = "EUR">50.0</Money> </UnitPrice> <Description xml:lang = "en">Standard Material</Description> <UnitOfMeasure>PCE</UnitOfMeasure> <PriceBasisQuantity quantity = "1.0" conversionFactor = "1"> <UnitOfMeasure>PCE</UnitOfMeasure> </PriceBasisQuantity> <Classification domain = "not available">Material group 1</Classification> <Extrinsic name = "extLineNumber">10</Extrinsic> </ItemDetail> <ControlKeys> <OCInstruction value = "notAllowed"/> <ASNInstruction value = "notAllowed"/> <InvoiceInstruction value = "isNotERS" verificationType = "goodsReceipt"/> </ControlKeys> <ScheduleLine quantity = "10.0" requestedDeliveryDate = "2019-03-15T12:00:00+01:00" lineNumber = "1"> <UnitOfMeasure>PCE</UnitOfMeasure> </ScheduleLine> </ItemOut> </OrderRequest>

Ejemplo: Versión del plan de entrega de transporte de stock

<Request deploymentMode = "production"> <OrderRequest> <OrderRequestHeader orderID = "4500030514" orderDate = "2019-03-13T12:00:00+01:00" orderType = "stockTransportRelease" type = "new" orderVersion = "1"> <Total> <Money currency = "EUR">500.0</Money> </Total> <ShipTo> <Address isoCountryCode = "DE" addressID = "0001" addressIDDomain = "buyerLocationID"> <Name xml:lang = "en">Werk 0001</Name>

146PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 147: 355a de soluciones cXML - help.sap.com

<PostalAddress name = "default"> <Street>Hasso-Plattner-Ring 7</Street> <City>Walldorf</City> <PostalCode>69190</PostalCode> <Country isoCountryCode = "DE"/> </PostalAddress> </Address> <IdReference identifier = "0001" domain = "buyerLocationID"/> </ShipTo> <BillTo> <Address isoCountryCode = "DE" addressID = "CUST_0123" addressIDDomain = "supplierID"> <Name xml:lang = "de">SAP A.G.</Name> <PostalAddress name = "SAP AG"> <Street>Hasso-Plattner-Ring 7</Street> <City>Walldorf</City> <PostalCode>69190</PostalCode> <Country isoCountryCode = "DE"/> </PostalAddress> </Address> <IdReference identifier = "CUST_0123" domain = "supplierID"/> <IdReference identifier = "0001" domain = "buyerID"/> </BillTo> <LegalEntity> <IdReference identifier = "0001" domain = "CompanyCode"> <Description xml:lang = "en">SAP A.G.</Description> </IdReference> </LegalEntity> <OrganizationalUnit> <IdReference identifier = "0001" domain = "PurchasingOrganization"> <Description xml:lang = "en">Einkaufsorg. 0001</Description> </IdReference> </OrganizationalUnit> <PaymentTerm payInNumberOfDays = "14"> <Discount> <DiscountPercent percent = "3.000"/> </Discount> </PaymentTerm> <PaymentTerm payInNumberOfDays = "20"> <Discount> <DiscountPercent percent = "2.000"/> </Discount> </PaymentTerm> <PaymentTerm payInNumberOfDays = "30"> <Discount> <DiscountPercent percent = "0.00"/> </Discount> </PaymentTerm> <Contact role = "supplierCorporate" addressID = "100000" addressIDDomain = "buyerID"> <Name xml:lang = "en">Großhändler THEURER</Name> <PostalAddress> <Street>Wasserturm Straße 121</Street> <City>Mannheim</City> <PostalCode>68059</PostalCode> <Country isoCountryCode = "DE"/> </PostalAddress> <Email name = "default">[email protected]</Email> <IdReference identifier = "100000" domain = "buyerID"/> </Contact> <TermsOfDelivery> <TermsOfDeliveryCode value = "TransportCondition"/> <ShippingPaymentMethod value = "Other"/> <TransportTerms value = "EXW">Ex Works</TransportTerms>

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 147

Page 148: 355a de soluciones cXML - help.sap.com

<Address> <Name xml:lang = "en">Walldoof</Name> </Address> </TermsOfDelivery> <OrderRequestHeaderIndustry> <ExternalDocumentType documentType = "NB"> <Description xml:lang = "en">Standard PO</Description> </ExternalDocumentType> </OrderRequestHeaderIndustry> </OrderRequestHeader> <ItemOut quantity = "10.0" lineNumber = "10" requestedDeliveryDate = "2019-03-15T12:00:00+01:00" itemCategory = "stockTransfer" stockTransferType = "intra" partialDelivery = "yes" orderCombination = "yes" > <ItemID> <SupplierPartID/> <BuyerPartID>STANDARD</BuyerPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency = "EUR">50.0</Money> </UnitPrice> <Description xml:lang = "en">Standard Material</Description> <UnitOfMeasure>PCE</UnitOfMeasure> <PriceBasisQuantity quantity = "1.0" conversionFactor = "1"> <UnitOfMeasure>PCE</UnitOfMeasure> </PriceBasisQuantity> <Classification domain = "not available">Material group 1</Classification> <Extrinsic name = "extLineNumber">10</Extrinsic> </ItemDetail> <ControlKeys> <OCInstruction value = "notAllowed"/> <ASNInstruction value = "notAllowed"/> <InvoiceInstruction value = "isNotERS" verificationType = "goodsReceipt"/> </ControlKeys> <ScheduleLine quantity = "10.0" requestedDeliveryDate = "2019-03-15T12:00:00+01:00" lineNumber = "1"> <UnitOfMeasure>PCE</UnitOfMeasure> </ScheduleLine> </ItemOut> </OrderRequest>

ShipTo, BillTo y sus elementos secundariosLos elementos ShipTo y BillTo contienen las direcciones de las entidades ShipTo y BillTo del pedido. La dirección ShipTo también puede aparecer a nivel de artículo. Todos los artículos deben facturarse a una sola entidad, de modo que el elemento BillTo solo aparezca en OrderRequestHeader.

Elemento Name [página 149]

Elemento DeliverTo, línea uno [página 149]

Elemento DeliverTo, línea dos [página 149]

Elemento Street [página 150]

Elemento City [página 150]

148PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 149: 355a de soluciones cXML - help.sap.com

Elemento State [página 150]

Elemento PostalCode [página 150]

Elemento CarrierIdentifier [página 151]

Elemento TransportInformation [página 151]

Country / isoCountryCode [página 152]

Elemento TelephoneNumber [página 152]

Elemento Fax [página 153]

Elemento Email [página 153]

Elemento URL [página 153]

Elemento Name

Para Expedir a, el valor del elemento Name debe ser la empresa o la organización del empleado que recibe los productos pedidos. Para Facturar a, este es el departamento o grupo responsable del pago. Name no es tan específico como la ubicación referenciada en la segunda línea DeliverTo.

<Name xml:lang="en">Workchairs, Inc.</Name>

Elemento DeliverTo, línea uno

El elemento DeliverTo en la línea uno es el nombre de la persona que recibe los productos pedidos.

Evite los elementos y atributos vacíos o con espacios en blanco. Si faltan valores esto puede afectar a los proveedores EDI y cXML.

La plantilla de formato del nombre para la implementación sugerida es “nombre apellido.”

NotaPor motivos de consistencia, las dos líneas DeliverTo del elemento BillTo deben tener el mismo formato. Esta lógica no está en las plantillas existentes. Agréguela manualmente.

<DeliverTo>Joe Smith</DeliverTo>

Elemento DeliverTo, línea dos

El elemento DeliverTo en la línea dos corresponde a la ubicación (edificio, ciudad, oficina o punto de recogida) de la persona que recibe los productos pedidos. Las ubicaciones deben completarse siempre lo suficiente para una etiqueta de correo.

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 149

Page 150: 355a de soluciones cXML - help.sap.com

NotaPor motivos de consistencia, las dos líneas DeliverTo del elemento BillTo deben tener el mismo formato. Esta lógica no está en las plantillas existentes. Agréguela manualmente.

<DeliverTo>Mailstop M-543</DeliverTo>

Elemento Street

El elemento Street es la dirección postal de la ubicación ShipTo o BillTo a la que los productos pedidos se han de expedir o facturar. Se permite un máximo de cuatro elementos Street para indicar direcciones de varias líneas.

<Street>123 Anystreet</Street> <Street>M/S 450</Street>

Elemento City

El elemento City es la ciudad a la que se han de expedir o facturar los productos pedidos.

<City>Sunnyvale</City>

Elemento State

El elemento State es un código de estado, provincia o región de dos letras correspondiente a la ubicación a la que los bienes deben expedirse o facturarse.

<State>CA</State>

Encontrará más información en Elementos Country, State y PostalCode [página 29].

Elemento PostalCode

El elemento PostalCode es el código postal al que los bienes deben expedirse o facturarse. No utilice guiones (-) en los códigos postales ampliados de Estados Unidos.

<PostalCode>90489</PostalCode>

Encontrará más información en Elementos Country, State y PostalCode [página 29].

150PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 151: 355a de soluciones cXML - help.sap.com

Elemento CarrierIdentifier

El elemento CarrierIdentifier contiene el nombre del transportista de la expedición.

<ShipTo> <Address> <Name xml:lang="USD">Acme</Name> <PostalAddress name="Headquarters"> <DeliverTo>Joe Smith</DeliverTo> <DeliverTo>Mailstop M-543</DeliverTo> <Street>123 Anystreet</Street> <City>Sunnyvale</City> <State>CA</State> <PostalCode>90489</PostalCode> <Country isoCountryCode="US">UnitedStates</Country> </PostalAddress> <CarrierIdentifier domain="companyName">UPS</CarrierIdentifier> </Address>

Elemento TransportInformation

El elemento TransportInformation contiene la información de transporte para un pedido de compra o un aviso de expedición. Este elemento se especifica sólo en el nivel de cabecera.

El elemento TransportInformation contiene los siguientes elementos:

Elemento Descripción

Route Método de expedición para la expedición. Es obligatorio si selecciona un transportista.

Este elemento tiene el atributo siguiente:

● MethodLos posibles valores para el método de expedición son:

● por aire● por carretera● por ferrocarril● marítimo

ShippingContractNumber El número de contrato asociado al contrato de venta.

ShippingInstructions Información acerca de la expedición

Ejemplo

<OrderRequestHeader orderDate="2010-03-26T16:40:53" orderID="POw4401" orderType="regular" type="Update"> <Total> <Money currency="USD">10.00</Money> </Total> <ShipTo> <Address>

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 151

Page 152: 355a de soluciones cXML - help.sap.com

<Name xml:lang="USD">Acme</Name> <PostalAddress name="default"> <DeliverTo>Joe Smith</DeliverTo> <DeliverTo>Mailstop M-543</DeliverTo> <Street>123 Anystreet</Street> <City>Sunnyvale</City> <State>AL</State> <PostalCode>35762</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> </Address> <CarrierIdentifier domain="companyName">UPS</CarrierIdentifier> <TransportInformation> <Route method="motor"/ <ShippingContractNumber>145</ShippingContractNumber> <ShippingInstructions> <Description xml:lang="en-US">As per the contract</Description> </ShippingInstructions> </TransportInformation> . . .

Country / isoCountryCode

El atributo isoCountryCode es el código de país según la norma ISO 3166. El contenido para Country es un nombre que se puede leer o imprimir.

<Country isoCountryCode="US">United States</Country>

Encontrará más información en Elementos Country, State y PostalCode [página 29].

Elemento TelephoneNumber

El elemento TelephoneNumber es el número de teléfono de la persona o el departamento al que se expiden o facturan los productos pedidos.

En el caso de la marcación internacional, el CountryCode contiene el código de marcación ITU correspondiente a un país tras cualquier código de escape. El código de marcación ITU es el código de acceso para un país en concreto.

Ejemplo de Estados Unidos:

<TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode>650</AreaOrCityCode> <Number>9308410</Number> </TelephoneNumber>

Ejemplo de Londres:

<TelephoneNumber> <CountryCode isoCountryCode="UK">44</CountryCode> <AreaOrCityCode>20</AreaOrCityCode> <Number>78628500</Number>

152PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 153: 355a de soluciones cXML - help.sap.com

</TelephoneNumber>

Encontrará más información en Sistemas de codificación recomendados [página 422].

Elemento Fax

El elemento Fax es el número de fax de la persona o departamento dónde deben expedirse o facturar los productos.

Ejemplo de Estados Unidos:

<Fax name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode>408</AreaOrCityCode> <Number>3582100</Number> </TelephoneNumber> </Fax>

Ejemplo de Londres:

<Fax> <TelephoneNumber> <CountryCode isoCountryCode="GB">44</CountryCode> <AreaOrCityCode>137</AreaOrCityCode> </TelephoneNumber> </Fax>

Elemento Email

El elemento Email es la dirección de correo electrónico de una persona o un departamento al que se han de expedir o facturar los productos pedidos. Ariba Network envía información de estado a la dirección ShipTo Email cuando el estado del pedido se actualiza o como resultado de una ConfirmationRequest o ShipNoticeRequest.

Ariba Network utiliza el atributo opcional preferredLang (producido por Ariba Buyer 8.2 o posteriores) en el elemento Email para especificar el idioma del destinatario.

<Email>[email protected]</Email> <Email preferredLang="ja-JP">[email protected]</Email>

Elemento URL

El elemento URL es la expedición a la URL. Es opcional el hecho de proporcionar un valor para este elemento.

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 153

Page 154: 355a de soluciones cXML - help.sap.com

Ejemplo

<URL>https://www.workchairs.com</URL>

Elemento BusinessPartner

Contiene información sobre el socio comercial de un artículo. Este elemento se puede utilizar para suministrar información de "Vendido a", "Expedir desde" y "Dirección de procesamiento de pedido" de un artículo.

NotaLos compradores también pueden pasar información de "Vendido a" a los proveedores dentro de un elemento Contact de un pedido. Sin embargo, la acción de pasar información de "Vendido a" dentro de un elemento Contact ha quedado en desuso, por lo que se recomienda utilizar el elemento BusinessPartner. Para la compatibilidad con versiones anteriores, aún se admite la asignación de información de "Vendido a" en el elemento Contact.

BusinessPartner tiene los siguientes atributos:

Atributo Descripción

type(obligatorio)

Identifica el tipo del socio comercial. El único valor posible es organization.

role(obligatorio)

Indica el rol que desempeña el socio en el proceso de compra. Los valores posibles son soldTo, shipFrom y orderingAddress.

RestricciónEn este momento, SAP Ariba solo admite el rol shipFrom.

BusinessPartner tiene los siguientes elementos:

Elemento Descripción

Address (obligatorio)

Proporciona una descripción del socio comercial. Siga estas instrucciones para cada role:

● shipFrom: addressIDDomain debería establecerse en "shipFro­mAddressID". addressID debería establecerse en el ID del emisor de la mercancía. Utilice el nombre para la descripción.

IdReference La referencia de ID está dentro del contexto de aplicación (por ejemplo, un determinado par de comprador y proveedor). El par (identificador y domi­nio) debe ser unívoco.

En el ejemplo siguiente se muestra un elemento BusinessPartner:

<BusinessPartner type = "organization" role = "shipFrom"> <Address isoCountryCode = "EN"

154PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 155: 355a de soluciones cXML - help.sap.com

addressID = "0002" addressIDDomain = "shipFromAddressID"> <Name xml:lang = "de">SAP A.G.</Name> <PostalAddress name = "SAP Labs LLC"> <Street>Hillview Ave 3450</Street> <City>Palo Alto</City> <PostalCode>94304</PostalCode> <Country isoCountryCode = "US"/> </PostalAddress> </Address> </BusinessPartner>

Elemento TermsofDelivery

El elemento TermsOfDelivery especifica las condiciones de entrega de un pedido de compra o un aviso de expedición. El elemento TermsofDelivery puede aparecer en el nivel de cabecera o de artículo en línea. Para agregarlo en el nivel de artículo en línea, incluya este elemento al elemento ItemOut.

NotaTambién puede agregar este elemento a la ShipNoticeHeader para especificar las condiciones en el nivel de cabecera. Para agregarlo en el nivel de artículo en línea, inclúyalo en el elemento ShipNoticeItem. Para obtener más información, consulte Elemento TermsofDelivery [página 248].

El elemento TermsofDelivery contiene los siguientes elementos:

Elemento Descripción

TermsOfDeliveryCode Condiciones de entrega predetermi­nadas.

ShippingPaymentMethod Denota el modo de pago de la expedi­ción.

● Cuenta: Si cargos de expedición se cargan a una cuenta.

● Cobro: Cuando el destinatario paga los cargos de transporte.

● Prepagado por vendedor: Cuando el vendedor realiza el pago al transportista para los cargos de transporte antes de la expedición.

● Mixto: Cuando el envío es par­cialmente Cobro y parcialmente Prepagado.

● Otros: Cualquier otro método de pago de expedición o un tercero paga los cargos de envío. Puede introducir información adicional del método de pago.

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 155

Page 156: 355a de soluciones cXML - help.sap.com

Elemento Descripción

TransportTerms Las condiciones de transporte:

● Franco transportista● CostAndFreight● DeliveredAtFrontier● Otros: Si especifica esta opción,

puede introducir adicionalmente una descripción.

Address La dirección Entregar a para el aviso de expedición.

Comments Información adicional de las condicio­nes de entrega.

Comments Información adicional si se seleccio­nan "otras" condiciones de trans­porte.

Ejemplo

<TermsOfDelivery> <TermsOfDeliveryCode value=”PriceCondition”/> <ShippingPaymentMethod value=”AdvanceCollect”/> <TransportTerms value=”Other”>Contract Terms</TransportTerms> <Address> <Name xml:lang=”en-US”>SNV</Name> PostalAddress name=”default”> <Street>123 street</Street> <City>Sunnyvale</City> <State>AL</State> <PostalCode>35762</PostalCode> <Country isoCountryCode=”US”>United States</Country> </PostalAddress> </Address> <Comments xml:lang=”en-US” type=”Transport”>Transport instructions</Comments> <Comments xml:lang=”en-US” type=”TermsOfDelivery”>Delivery at the doorstep</Comments> </Terms Of Delivery>

Elemento Tax

Este elemento incluye los detalles de los impuestos del pedido de compra. Este elemento está presente si la organización compradora calcula impuestos. Si aparece dentro del elemento OrderRequestHeader, Tax describe el impuesto total para un pedido.

<Tax> <Money currency="USD">1.34</Money> <Description xml:lang="en">Sales Tax</Description> </Tax>

156PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 157: 355a de soluciones cXML - help.sap.com

Los elementos Tax de nivel de artículo en línea están anidados en el elemento ItemOut y describen los impuestos aplicados en los artículos en línea del pedido de compra. Los pedidos de compra generados por Soluciones de SAP Ariba Procurement sólo tienen impuestos a nivel de línea. En el siguiente ejemplo, el código de impuesto Tax Code1 se ha aplicado en el artículo en línea. El importe total de impuestos para el código de impuesto 10,96€. De este, 8€ es el importe del tipo de impuesto VAT y 2,96 es el importe del tipo de impuesto Cess.

<ItemOut> :: <Tax> <Money currency="USD">10.96</Money> <Description xml:lang="en">Tax Code1</Description> <TaxDetail category="VAT"> <TaxAmount> <Money currency="USD">8.00</Money> </TaxAmount> <Description xml:lang="en">VAT Description</Description> </TaxDetail> <TaxDetail category="Cess"> <TaxAmount> <Money currency="USD">2.96</Money> </TaxAmount> <Description xml:lang="en">Cess Description</Description> </TaxDetail> </Tax></ItemOut>

El elemento Money en el elemento Tax se utiliza para capturar totales para todos los importes de impuestos y no se utiliza para la visualización de la factura.

Impuestos retenidos

Al elemento Tax pueden agregarse dos elementos extrínsecos:

● withholdingTax(para retenciones fiscales totales) y● withholdingTaxTotal (para impuestos totales menos retención fiscal)

El ejemplo siguiente muestra cómo se ven los datos de la retención fiscal en una factura cuando se exportan a cXML. A la factura se le aplicó un tipo de retención fiscal del -2 % y esta se envió vía Ariba Network. El uso de tipos negativos garantiza la compatibilidad con versiones anteriores de aplicaciones cXML existentes.

<Tax> <Money currency="USD">1273.35</Money> <Description xml:lang="en-US"></Description> <TaxDetail category="withholdingTax" percentageRate="-2"> <TaxableAmount> <Money currency="USD">25466.90</Money> </TaxableAmount> <TaxAmount> <Money currency="USD">-509.34</Money> </TaxAmount> <Description xml:lang="en-US"></Description> </TaxDetail> <TaxDetail category="vat" percentageRate="7" taxPointDate="2011-03-11T00:00:00-08:00"> <TaxableAmount> <Money currency="USD">25466.90</Money> </TaxableAmount> <TaxAmount>

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 157

Page 158: 355a de soluciones cXML - help.sap.com

<Money currency="USD">1782.69</Money> </TaxAmount> <Description xml:lang="en-US"></Description> </TaxDetail> <Extrinsic name="withholdingTaxTotal"> <Money currency="USD">-509.34</Money> </Extrinsic> <Extrinsic name="taxTotal"> <Money currency="USD">1782.69</Money> </Extrinsic> </Tax>

Elemento Modifications

El elemento Modifications contiene detalles de las deducciones y los cargos aplicables en el nivel de cabecera y en el nivel de artículo en línea.

Este elemento ofrece detalles de:

● Cualquier coste o deducción adicionales que altere el precio original o precio de expedición del artículo.● Uno o varios elementos Modification

El elemento Modification tiene un atributo opcional level, que puede tener un valor entero. Se utiliza para visualizar en qué nivel se aplica una modificación en concreto. Para obtener más información, consulte Atributo de nivel [página 310].

Puede agregar el elemento Modifications al elemento Shipping. Las modificaciones en el nivel de artículo en línea se pueden agregar en el nivel de artículo o en el nivel de precio por unidad según las configuraciones del comprador. Tiene los elementos siguientes:

Elemento Descripción

OriginalPrice El precio original del artículo. Las deducciones y los cargos se aplican en el precio original.

Este elemento tiene el elemento Money. También contiene un atributo type opcional.

Por ejemplo, el valor type puede ser el MSRP, ListPrice, Actual, AverageSellingPrice, CalculationGross, BaseCharge, AverageWholesalePrice, ExportPrice, AlternatePrice, ContractPrice, etc.

AdditionalDeduction Los detalles de las deducciones disponibles para el artículo. Sólo se utiliza cuando se aplican las deducciones.

Este elemento puede tener cualquiera de los siguientes elementos que definen el valor de de­ducción:

● DeductionAmount: Este elemento tiene el elemento Money.● DeductionPercent: Tiene un atributo percent.● DeductedPrice: Este elemento tiene el elemento Money. Contiene el precio final del

artículo. Este precio sustituye el precio del artículo.

El elemento AdditionalDeduction tiene un atributo type opcional. Contiene detalles de los tipos de deducciones disponibles para el artículo.

158PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 159: 355a de soluciones cXML - help.sap.com

Elemento Descripción

AdditionalCost Los detalles de los cargos adicionales aplicados en un artículo.

Contiene los elementos siguientes:

● Money: Introduzca el valor del dinero en el atributo value. Es un atributo obligatorio.● Percentage: Introduzca el valor de porcentaje en el atributo percent. Es un atributo

obligatorio.

ModificationDetail Los detalles de cualquier información para el elemento AdditionalDeduction o el ele­mento AdditionalCost.

Este elemento ModificationDetail tiene los elementos siguientes:

● Description● Extrinsic● Code

Este elemento tiene los atributos siguientes:

● name: Es un atributo obligatorio.● startDate: Es un atributo opcional.● endDate: Es un atributo opcional.

Impuesto Este impuesto es para las deducciones y los cargos.

NotaEl elemento OriginalPrice es un elemento opcional cuando se agrega como parte del elemento Modification.

Ejemplo de modificaciones a nivel de cabecera

<OrderRequestHeader orderDate="2012-11-19T10:15:00-08:00" orderID="1_2482012_5" orderType="regular" type="new"> <Total> <Money currency="USD">65.00</Money> </Total> <Modifications> <Modification> <OriginalPrice> <Money currency = "USD">40.00</Money> </OriginalPrice> <AdditionalCost> <Money currency = "USD">10</Money> </AdditionalCost> <ModificationDetail endDate="2013-11-30T10:15:00-08:00" name="Access Charges" startDate="2012-11-19T10:15:00-08:00"> <Description xml:lang="en-US">Access Charges</Description> </ModificationDetail> </Modification> </Modifications> </OrderRequestHeader>

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 159

Page 160: 355a de soluciones cXML - help.sap.com

Ejemplo de modificaciones a nivel de artículo en línea

En el siguiente ejemplo, se ha aplicado un descuento de 2,00€ y un cargo de seguro de 3,00€ en un artículo en línea con el importe 14,95€.

<UnitPrice> <Money alternateCurrency="" alternateAmount="" currency="USD">14.95</Money> <Modifications> <Modification> <AdditionalDeduction> <DeductionAmount> <Money alternateCurrency="" alternateAmount="" currency="USD">2.00</Money> </DeductionAmount> </AdditionalDeduction> <ModificationDetail name="Discount"> <Description xml:lang="en-US">Discount</Description> </ModificationDetail> </Modification> <Modification> <AdditionalCost> <Money alternateCurrency="" alternateAmount="" currency="USD">3.00</Money> </AdditionalCost> <ModificationDetail name="Insurance"> <Description xml:lang="en-US">Insurance Charges</Description> </ModificationDetail> </Modification> </Modifications></UnitPrice>

Elemento Distribution

El elemento Distribution facilita el proceso de reconciliación de la organización compradora. Esto permite a los solicitantes dividir los cargos de los artículos en línea entre múltiples grupos o cuentas.

El elemento Distribution puede contener cualquier código de contabilidad relevante utilizado por una organización compradora. Así por ejemplo, si un artículo en línea tiene una división bidireccional (p. ej. 60/40), debería haber dos elementos Distribution.

El elemento Distribution puede contener elementos Accounting, AccountingSegment y Segment.

Elemento Accounting

El elemento Accounting agrupa segmentos para identificar quién o cuál es el grupo responsable de los costes de un artículo en línea. El atributo name identifica la combinación de contabilidad. El valor predeterminado de name esDistributionCharge:

<Accounting name="DistributionCharge">

Los datos del elemento Accounting se combinan para formar el código de contabilidad real, por ejemplo, a-b-c dónde a, b, y c son los ID de los segmentos de contabilidad.

160PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 161: 355a de soluciones cXML - help.sap.com

Ejemplo

<Distribution> <Accounting name="split 60%"> <AccountingSegment id="2911"> <Name xml:lang="en">Department</Name> <Description xml:lang="en">Development</Description> </AccountingSegment> <AccountingSegment id="345"> <Name xml:lang="en">Account</Name> <Description xml:lang="en">Computer Accessories</Description> </AccountingSegment> </Accounting> <Charge> <Money currency="USD">288</Money> </Charge></Distribution><Distribution> <Accounting name="split 40%"> <AccountingSegment id="2911"> <Name xml:lang="en">Department</Name> <Description xml:lang="en">Development</Description> </AccountingSegment> <AccountingSegment id="123"> <Name xml:lang="en">Account</Name> <Description xml:lang="en">Office Supplies</Description> </AccountingSegment> </Accounting> <Charge> <Money currency="USD">192</Money> </Charge> </Distribution>

En el ejemplo, cada Distribution/Accounting tiene dos elementos AccountingSegment, con los mismos patrones de nombre. Todo el cargo es para el mismo departamento, pero el segmento "Cuenta" está dividido (60% para accesorios de ordenador y 40% para suministros de oficina). Los elementos Charge para un artículo deben sumarse hasta el precio total del artículo.

En el ejemplo, el número de dígitos en los atributos id son consistentes dónde el elemento Name es el mismo. Es decir, el segmento Departamento tiene un número de cuatro dígitos y el segmento Cuenta tiene un número de tres dígitos. La estructura de los segmentos de contabilidad debe ser consistente.

Las organizaciones compradoras no necesitan revelar toda la información de contabilidad, sólo la información de contabilidad para este pedido de compra. Dado que los segmentos están nombrados y dependen de la posición en la estructura de contabilidad, las organizaciones compradoras sólo pueden proporcionar la que desean representar.

NotaAlgunas configuraciones de Ariba Buyer generan datos de contabilidad de forma inoportuna. Por ejemplo, colocan el porcentaje dividido en un elemento AccountingSegment, lo que resulta en códigos de contabilidad como por ejemplo 75%-123-45-ABC, dónde 123, 45 y ABC tienen sentido, como por ejemplo sector, proyecto y departamento, pero el 75% es difícil de procesar.

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 161

Page 162: 355a de soluciones cXML - help.sap.com

Elemento ControlKeys

El elemento ControlKeys en la estructura cXML le permite ignorar las reglas empresariales predeterminadas para las confirmaciones del pedido, los avisos de expedición, las hojas de entrada de servicios y las facturas. ControlKeys tiene los siguientes elementos:

Elemento Descripción

OCInstruction Indica si se permite una confirmación del pedido para este pedido o artículo en línea, independientemente de las reglas empresariales predeterminadas configuradas en Ariba Network.

ASNInstruction Indica si se permite un aviso de expedición para este pedido o artículo en línea, inde­pendientemente de las reglas empresariales predeterminadas configuradas en Ariba Network.

SESInstruction Indica si se permite una hoja de entrada de servicios para este pedido o artículo en línea, independientemente de las reglas empresariales predeterminadas configura­das en Ariba Network. También indica si los proveedores pueden cambiar el precio por unidad en la hoja de entrada de servicios.

InvoiceInstruction Indica si se permite una factura para este pedido o artículo en línea, independiente­mente de las reglas empresariales predeterminadas configuradas en Ariba Network. También indica si los proveedores pueden cambiar el precio por unidad en la factura.

En el siguiente ejemplo:

● El atributo InvoiceInstruction@value se establece en "isERS", lo que desactiva la creación de facturas en función de un artículo en línea marcado para ERS en el pedido de compra. Puede utilizar el elemento secundario InvoiceInstruction para diferenciar facturas normales de las facturas ERS.

● El atributo unitPriceEditable se establece en "yes", lo que indica que el proveedor puede cambiar el precio por unidad para la factura o la hoja de entrada de servicios.

Ejemplo

<ItemOut lineNumber="1" quantity="2" requestedDeliveryDate="2008-09-21"> <ItemID><SupplierPartID>AX4518</SupplierPartID><SupplierPartAuxiliaryID>AXSPA001</SupplierPartAuxiliaryID></ItemID><ItemDetail><UnitPrice><Money currency="USD">31.20</Money></UnitPrice><Description xml:lang="en">BULLNOSE SHELVES 4 PK</Description><UnitOfMeasure>PK</UnitOfMeasure><Classification domain="SPSC">foo</Classification><ManufacturerPartID>AX4518</ManufacturerPartID><ManufacturerName>20008496</ManufacturerName></ItemDetail><Distribution><Accounting name="DistributionCharge"><Segment description="Entertainment" id="23456" type="G/L Account"/>

162PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 163: 355a de soluciones cXML - help.sap.com

<Segment description="Western Region Sales" id="2323" type="Cost Center"/></Accounting><Charge><Money currency="USD">187.20</Money></Charge></Distribution> <ControlKeys> <InvoiceInstruction unitPriceEditable="yes" value="isERS"/><SESInstruction unitPriceEditable="yes" value="allowed"/></ControlKeys> </ItemOut>

Elemento AccountingSegment

El elemento AccountingSegment identifica el segmento de contabilidad relativo a los demás en el elemento Accounting.

AccountingSegment tiene un atributo, id, que es el identificador único en un AccountingSegment Name (por ejemplo, el código de contabilidad real).

Contiene dos elementos: Name y Description. El elemento Name identifica el segmento de contabilidad relativo a los demás en el elemento Accounting y Description especifica el valor del ID, que suele ser ID, aunque pueden utilizarse otros valores.

AccountingSegment puede contener cualquier código de contabilidad relevante utilizado por la organización compradora. Ariba Buyer propaga estos elementos desde un nombre de cuenta y un centro de costes del artículo en línea. A continuación, encontrará algunos ejemplos de posibles valores: asset number, billing code, cost center, G/L account y department.

Ejemplo

<Distribution> <Accounting name="DistributionCharge"> <AccountingSegment id="456"> <Name xml:lang="en-US">G/L Account</Name> <Description xml:lang="en-US">ID</Description> </AccountingSegment> <AccountingSegment id="23"> <Name xml:lang="en-US">Cost Center</Name> <Description xml:lang="en-US">ID</Description> </AccountingSegment> </Accounting> <Charge> <Money currency="USD">4688.00</Money> </Charge> </Distribution>

En el ejemplo, el cargo G/L Account se corresponde con la cuenta 456 y el cargo Cost Center se corresponde con la cuenta 23.

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 163

Page 164: 355a de soluciones cXML - help.sap.com

Elemento Segment (en desuso)

El elemento Segment identifica el segmento de contabilidad relativo a los demás en el elemento Accounting. Segment está en desuso, se ha sustituido por el elemento AccountingSegement en cXML 1.2.005, pero el proveedor debe poder procesar Segment porqué aún lo genera Ariba Buyer 6, 7 y 8.

Segment tiene tres atributos: type, id y description. type identifica el segmento relacionado con los demás en el elemento Accounting. id es el identificador unívoco en un Segment type (por ejemplo, el código de contabilidad real). description describe el valor id.

Segment puede contener cualquier código de contabilidad relevante utilizado por la organización compradora. Ariba Buyer propaga estos elementos desde un nombre de cuenta y un centro de costes del artículo en línea. A continuación, encontrará algunos ejemplos de posibles valores: asset number, billing code, cost center, G/L account y department. Los valores también pueden incluir información de contabilidad para los campos de asignación de cuenta de gestión de fondos. Algunos ejemplos de campos de asignación de cuenta de gestión de fondos son Fund, Budget Period, Funds Center, Commitment Item, Earmarked Funds Document, Functional Area, Grant y FM Area.

Ejemplo

<Distribution> <Accounting name="DistributionCharge"> <Segment description="Travel" id="456" type="G/L Account"/> <Segment description="European Projects" id="23" type="Cost Center"/> <Segment description="Fund001" id="301" type="Fund" /> <Segment description="BP2015" id="BP1" type="Budget Period" /> <Segment description="FC1000" id="1200" type="Funds Center" /> <Accounting"> <Charge> <Money currency="USD">4688.00</Money> </Charge> </Distribution>

En el ejemplo Travel describe el cargo G/L Account y se corresponde con la cuenta 456. Este ejemplo también incluye información de contabilidad de gestión de fondos para los campos Fund, Budget Period y Funds Center.

Campos de contabilidad en SAP Ariba Invoice Management

Los pedidos de compra enviados a SAP Ariba Invoice Management han esperado asignaciones cXML para campos divididos de campos de contabilidad.

164PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 165: 355a de soluciones cXML - help.sap.com

Ejemplo

<ItemOut quantity="2.0" lineNumber="0000000001" requestedDeliveryDate="2009-03-12T10-03-39+01:00"> <ItemID><SupplierPartID></SupplierPartID></ItemID> <ItemDetail> <UnitPrice><Money currency="EUR">50.0</Money></UnitPrice> <Description xml:lang="en">TESTING <ShortName>TEST_07</ShortName> </Description> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="UNSPSC">10401501</Classification> <ManufacturerPartID></ManufacturerPartID> <Extrinsic name="AccountCategory">K</Extrinsic> <Extrinsic name="ItemCategory">M</Extrinsic> <Extrinsic name="CompanyCode">0100</Extrinsic> <Extrinsic name="PurchaseGroup">0001</Extrinsic> </ItemDetail> <Distribution> <Accounting name="Accounting Information"> <AccountingSegment id="100"> <Name xml:lang="en">Percentage</Name> <Description xml:lang="en">Percentage</Description> </AccountingSegment> <AccountingSegment id="0000015300"> <Name xml:lang="en">GeneralLedger</Name> <Description xml:lang="en">ID</Description> </AccountingSegment> <AccountingSegment id="07801042A0"> <Name xml:lang="en">CostCenter</Name> <Description xml:lang="en">ID</Description> </AccountingSegment> </Accounting> <Charge> <Money currency="EUR">50.0</Money> </Charge> </Distribution> </ItemOut>

Tipos de recepción en SAP Ariba Invoice Management

Muchos sistemas ERP esperan una coincidencia entre una factura y los pedidos asociados para artículos que no precisan recibo. Normalmente, estos sistemas ERP indican si un recibo es necesario o no.

El extrínseco ReceivingType indica si un recibo es necesario o no. Se admiten los valores siguientes para el extrínseco ReceivingType:

ReceivingType Resultado

4 No precisa recibo. Reconciliar por cantidad. Los artículos en línea de la factura se reconcilian con líneas de pedido basadas en cantidad.

10 No precisa recibo. Reconciliar por importe. Las líneas de factura se reconcilian sólo según el valor del campo Importe.

cualquier otro valor Desencadena tres excepciones de factura diferentes entre la factura, los recibos y el pedido.

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 165

Page 166: 355a de soluciones cXML - help.sap.com

Ejemplo

<ItemOut quantity="2.0" lineNumber="0000000001" requestedDeliveryDate="2009-03-12T10-03-39+01:00"> <ItemID><SupplierPartID></SupplierPartID></ItemID> <ItemDetail><UnitPrice><Money currency="EUR">50.0</Money></UnitPrice> <Description xml:lang="en">TESTING<ShortName>TEST_07</ShortName></Description> UnitOfMeasure>EA</UnitOfMeasure><Classification domain="UNSPSC">10401501</Classification> <ManufacturerPartID></ManufacturerPartID> <Extrinsic name="ReceivingType">4</Extrinsic> . . .

Si ReceivingType es cualquier valor diferente a 4 o 10, o si ReceivingType no está presente en el elemento ItemDetail, la reconciliación de factura incluye la coincidencia de recibos con facturas y pedidos. El proveedor puede ver el tipo de recepción en Ariba Network al revisar detalles de pedido.

Integración ReceivingType con sistemas externos

La integración ReceivingType con un sistema ERP externo depende de cómo el sistema externo gestiona los requisitos de los recibos. Por ejemplo, algunos sistemas ERP sólo indican en el nivel de cabecera si un recibo es obligatorio. Es preciso que estructure su propia lógica empresarial para fijar el indicador de recibo obligatorio en el nivel de línea en función de sus prácticas y necesidades empresariales.

En SAP, la casilla de selección Verificación de facturas basada en RM indica si un recibo es obligatorio para la verificación de facturas. Debe configurar su asignación personalizada para fijar el extrínseco ReceivingType en 4 para artículos en los que esta casilla no está marcada en SAP. Si la casilla "Verificación de facturas basada en EM" está marcada en SAP, puede omitir la configuración del extrínseco ReceivingType por completo o fijar ReceivingType en cualquier otro valor distinto de 4, lo que incluye que también puede dejarlo en blanco.

Elemento BlanketItemDetail

El elemento BlanketItemDetail proporciona detalles específicos sobre artículos del pedido de compra global y artículos del pedido de servicio sin planificar.

NotaAriba Network no admite líneas de servicio en pedidos de compra globales. Las líneas de servicio sólo se admiten en los pedidos de compra de servicio.

BlanketItemDetail en pedidos de compra globales

El elemento BlanketItemDetail puede aparecer en tres tipos diferentes de pedidos de compra globales: Proveedor, mercancía y artículo.

166PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 167: 355a de soluciones cXML - help.sap.com

● Nivel de proveedor: Sólo contiene un artículo en línea que define las condiciones del acuerdo de nivel de proveedor, y también puede contener un importe máximo.

● Nivel de mercancía: Contiene uno o más artículos en línea que corresponden a diferentes mercancías que el pedido de compra global captura. Este tipo de artículo en línea tiene un proveedor, una mercancía y límites. En este caso, ItemID debe incluir una etiqueta SupplierID vacía.

● Nivel de artículo: Contiene información similar al elemento ItemDetail, excepto que todos los elementos son opcionales principalmente.

Los extrínsecos siguientes no son visibles para el proveedor, pero necesarios por Ariba Network para fines de implementación interna:

● Ariba.availableAmount: Un valor numérico enviado sólo en la creación de un pedido de compra global.● Ariba.invoicingAllowed: Un valor booleano que especifica si Ariba Network permite a los proveedores

crear facturas de conversión de PO para pedidos de compra o pedidos de compra globales. Sí indica un pedido de compra global sin pedido preferente. No indica un pedido de compra global con pedido preferente.

● Ariba.collaborationAllowed: Un valor booleano que especifica si un punch in de proveedor puede crear las facturas.

NotaEl elemento BlanketItemDetail también puede contener la determinación de precios basados en cantidad para un artículo en línea en un pedido de compra global.

Información relacionada

Elemento PriceBasisQuantity [página 178]

BlanketItemDetail en pedidos de compra de servicios

BlanketItemDetail describe artículos en línea en un pedido de compra de servicios que no se han planificado y no tienen ninguna especificación. Cuando los proveedores completan el pedido agregan artículos a la hoja de entrada de servicios para describir cómo han completado el pedido.

Para líneas de servicio sin planificar, el elemento BlanketItemDetail debe adjuntar un elemento MaxAmount que defina el importe máximo oculto que el proveedor no puede exceder cuando cree hojas de entrada de servicios.

Ejemplo

<ItemOut lineNumber="1" quantity="1" requestedDeliveryDate="2013-09-1" requiresServiceEntry="yes"> <ItemID> <SupplierPartID>LW4001</SupplierPartID><SupplierPartAuxiliaryID></SupplierPartAuxiliaryID> </ItemID>

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 167

Page 168: 355a de soluciones cXML - help.sap.com

<BlanketItemDetail> <Description xml:lang="en">Site preparation of parcel no. 110 (3 acres)</Description> <MaxAmount> <Money currency="USD">70000</Money> </MaxAmount> <UnitPrice><Money currency="USD">50000</Money></UnitPrice> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="ascc">606501</Classification> <Extrinsic name="Construction"></Extrinsic> <Extrinsic name="ServicePeriod"> <Period endDate="2013-09-01T23:59:59-00:00" startDate="2012-07-12T00:00:00-00:00"></Period> </Extrinsic> </BlanketItemDetail> </ItemOut>

Elemento ItemOutLos elementos ItemOut describen artículos pedidos individualmente.

ItemOut tiene los siguientes atributos:

Atributo Descripción

quantity(obligatorio)

El número de artículos deseado. Se permiten fracciones para algunas unidades de medida. Es posible que el proveedor ya haya verificado el valor durante una sesión PunchOut. Este valor nunca debe ser negativo.

lineNumber Posición del artículo dentro de un pedido. Este valor ordinal aumenta una vez por ItemOut en una OrderRequest "nueva". Los clientes siempre deben especificar este atributo en una OrderRequest, aunque podría no ser útil en otros contextos ItemOut.

requisitionID Identificador de solicitud del comprador para este artículo en línea. No se debe incluir si se especifica requisitionID en la OrderRequestHeader.

agreementItemNumber Identificador de acuerdo maestro del comprador para el artículo en línea.

requestedDeliveryDate Fecha en la que se ha solicitado la entrega del artículo, lo que permite las fechas de entrega a nivel de artículo en la OrderRequest. Debe tener el formato ISO 8601.

isAdHoc Indica que el artículo es un artículo por encargo. Los pedidos de compra por encargo contienen artículos introducidos manualmente por los solicitantes, y no artículos se­leccionados a partir de catálogos electrónicos. A menudo, estos artículos no tienen números de pieza válidos. Los pedidos por encargo suelen requerir una validación y procesamiento especiales.

Los usuarios introducen artículos por encargo para adquirir productos y servicios por encargo o porque no los han encontrado en los catálogos electrónicos.

parentLineNumber Número de línea del artículo en línea principal correspondiente. Se trata de un campo obligatorio y solo se puede aplicar a un artículo en línea con itemType="item".

168PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 169: 355a de soluciones cXML - help.sap.com

Atributo Descripción

itemType Especifica el tipo de artículo. Valores posibles:

● composite: Identifica un grupo de artículos.● item: Identifica un artículo en línea independiente.● lean: Indica que no hay ningún artículo inferior para la línea.

requiresServiceEntry Especifica si el artículo requiere o no una hoja de entrada de servicios ServiceEntryRequest para describir cómo se ha prestado.

confirmationDueDate Especifica la fecha en la que el proveedor debe responder al comprador que confirma la recepción del pedido de compra.

compositeItemType Especifica si un artículo de nivel superior utiliza la determinación de precios a nivel de grupo. Los valores posibles son "groupLevel" o "itemLevel".

itemClassification Especifica si el artículo en línea actual es un material o un servicio. Valores posibles:

● material● service

itemCategory Especifica cómo se aprovisiona un componente o material. Valores posibles:

● materialUnknown: hace referencia al aprovisionamiento de un material sin especificar el número de material.

● text: hace referencia al aprovisionamiento de un artículo de texto libre.● stockTransfer: hace referencia al traslado de stock de un centro a otro.● materialGroup: hace referencia al aprovisionamiento de un material sin es­

pecificar el valor o la cantidad.● subcontract—Suministro de un material proporcionando información de

componente a un fabricante contratado que fabrica el producto elaborado.● consignment—Gestionar un material mediante un proceso especial en el que

el pago al proveedor se retiene hasta que el comprador ha consumido el material o servicio.

● thirdParty—Suministro de material de un proveedor externo.● limit: indica que hay un límite previsto para los servicios o materiales no plani­

ficados cubiertos por este artículo.

subcontractingType El sistema ERP del comprador determina el tipo de subcontratación a partir del indi­cador de provisión de material determinado para ayudar en los escenarios de renova­ción o sustitución de subcontratación habituales. Valores posibles:

● regular: escenario de subcontratación estándar.● refurbWithoutChange: renovación sin material modificado.● refurbWithChange: renovación con material modificado.● replacement: sustitución de los materiales.

stockTransferType El sistema ERP del comprador envía el tipo de traslado de stock en función del pedido de transporte de stock o la orden de entrega de transporte de stock. Valores posibles:

● intra: hace refierencia al traslado de stock de un centro a otro dentro de la misma sociedad.

● inter: hace refierencia al traslado de stock de un centro a otro dentro en socie­dades distintas.

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 169

Page 170: 355a de soluciones cXML - help.sap.com

Atributo Descripción

requestedShipmentDate Fecha de expedición solicitada por el comprador para el artículo.

isReturn Se establece en "yes" para indicar que el artículo es un artículo de devolución.

returnAuthorizationNumber Número de autorización de devolución de un artículo en línea.

isDeliveryCompleted Se establece en yes para indicar que este artículo se considera cerrado y que no se esperan más entregas para este. El comprador fija este indicador con fines informati­vos.

unlimitedDelivery Se establece en yes para indicar que el artículo en línea admite entregas de cantida­des ilimitadas. La tolerancia de entrega ilimitada correspondiente se marca en ERP. Este indicador solo se utiliza durante la creación del aviso de expedición.

isItemChanged Se establece en yes para indicar que el artículo ha cambiado.

isKanban Se establece en yes para indicar que el artículo está marcado para el proceso Kan­ban. Los pedidos Kanban requieren tiempo y una calidad de entrega del 100%.

stoDelivery Las opciones de entrega posibles para el artículo de pedido de transporte de stock.

● full (predeterminado): solo se permite la entrega completa del pedido. Es es­pecífico del pedido de transporte de stock o de la liberación del transporte de stock.

● partial: se permite una entrega parcial del pedido. Es específico del pedido de transporte de stock o de la liberación del transporte de stock.

stoOrderCombination Si el atributo itemCategory tiene el valor "stockTransfer" y el atributo stoOrderCombination se establece en "yes", se pueden combinar artículos de distintos pedidos de transporte de stock con el indicador fijado durante la creación del aviso de expedición. Se fija un indicador para la combinación de pedidos en el ERP del comprador. Esta configuración es relevante para los pedidos de transporte de stock o las órdenes de entrega de transporte de stock.

Artículo modificado y marcado para un proceso Kanban

<ItemOut itemType="item" lineNumber="00001" quantity="10.00" requestedDeliveryDate="2019-01-02T10:00:00+06:00" requestedShipmentDate="2019-01-01T10:00:00+06:00" isItemChanged="yes" isKanban="yes" > <ItemID> <SupplierPartID>Supplier Part ID</SupplierPartID> <SupplierPartAuxiliaryID>Supplier Part Aux ID</SupplierPartAuxiliaryID> <BuyerPartID>Buyer Part ID</BuyerPartID> <IdReference domain="UPCConsumerPackageCode" identifier= "UP ID"></IdReference> </ItemID> <ItemDetail> <UnitPrice> <Money currency="EUR">20</Money> </UnitPrice> <Description xml:lang="en">ERP-7372 <ShortName>Short Description</ShortName>

170PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 171: 355a de soluciones cXML - help.sap.com

</Description> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="NotAvailable">007</Classification> <ManufacturerPartID>Manufacturer Part ID</ManufacturerPartID> <ManufacturerName xml:lang="en">Manufacturer Name</ManufacturerName> <ItemDetailIndustry isConfigurableMaterial="yes"> <ItemDetailRetail> <EANID>EAN ID</EANID> <EuropeanWasteCatalogID>EWC ID</EuropeanWasteCatalogID> <Characteristic domain="color" value="red"/> <Characteristic domain="component" value="Server"/> </ItemDetailRetail> </ItemDetailIndustry> </ItemDetail> <SupplierID domain="DUNS">Supplier DUNS ID</SupplierID> <Comments xml:lang="en"> Free Text</Comments> <Comments xml:lang="en">Terms and Conditions</Comments> <ScheduleLine quantity="10.00" requestedDeliveryDate="2019-01-02T10:00:00+06:00" > <UnitOfMeasure>EA</UnitOfMeasure> </ScheduleLine> <ItemOutIndustry planningType="CTO"> <ReferenceDocumentInfo lineNumber="000090"> <DocumentInfo documentID="0000006222" documentType="Sales Order XY"/> </ReferenceDocumentInfo> <ReferenceDocumentInfo> <DocumentInfo documentID="0001234567" documentType="ReplanishmentOrder"/> </ReferenceDocumentInfo> </ItemOutIndustry> </ItemOut>

Ejemplo: Artículos del tipo "composite" e "item" en un pedido

<ItemOut lineNumber="1" quantity="4" itemType="composite"> <ItemID> <SupplierPartID>AD1513</SupplierPartID> <SupplierPartAuxiliaryID></SupplierPartAuxiliaryID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">30</Money> </UnitPrice> <Description xml:lang="en"> Dining Set </Description> <UnitOfMeasure>EA</UnitOfMeasure> Classification domain="unspsc">432118</Classification> </ItemDetail> <Distribution> <Accounting name="DistributionCharge"> <AccountingSegment id="100"> <Name xml:lang="en">Percentage</Name> <Description xml:lang="en"> Percentage </Description> </AccountingSegment> </Accounting> Charge> <Money currency="USD"> 120</Money> </Charge> </Distribution></ItemOut> <ItemOut lineNumber="2" quantity="4" parentLineNumber=”1” itemType="item"> <ItemID>

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 171

Page 172: 355a de soluciones cXML - help.sap.com

<SupplierPartID>AD1514</SupplierPartID> <SupplierPartAuxiliaryID></SupplierPartAuxiliaryID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">2.50</Money> </UnitPrice> <Description xml:lang="en"> Fork </Description> <UnitOfMeasure>EA</UnitOfMeasure> Classification domain="unspsc">432118</Classification> </ItemDetail> </ItemOut>

Ejemplo: Artículo del tipo "lean" en un pedido

<ItemOut lineNumber="1" quantity="1" requestedDeliveryDate="2020-06-20T03:30:00-07:00" itemType="lean"> <ItemID> <SupplierPartID></SupplierPartID> </ItemID> <BlanketItemDetail> <Description xml:lang="en">Consulting services</Description> <UnitPrice> <Money alternateAmount="" alternateCurrency="" currency="CAD">800.00</Money> </UnitPrice> <UnitOfMeasure>AU</UnitOfMeasure> <Classification domain="ccc">A050</Classification> <Extrinsic name="ExpectedUnplanned"> <Money alternateAmount="" alternateCurrency="" currency="CAD">800.00</Money> </Extrinsic> </BlanketItemDetail> <SpendDetail> <Extrinsic name="service">service</Extrinsic> </SpendDetail> </ItemOut>

Ejemplo: Artículo para transporte de stock interno con entrega parcial y combinación de pedidos

<ItemOut quantity = "10.0" lineNumber = "10" requestedDeliveryDate = "2019-03-15T12:00:00+01:00" itemCategory = "stockTransfer" stockTransferType = "intra" stoDelivery = "partial" stoOrderCombination = "yes" >

172PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 173: 355a de soluciones cXML - help.sap.com

<ItemID> <SupplierPartID/> <BuyerPartID>STANDARD</BuyerPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency = "EUR">50.0</Money> </UnitPrice> <Description xml:lang = "en">Standard Material</Description> <UnitOfMeasure>PCE</UnitOfMeasure> <PriceBasisQuantity quantity = "1.0" conversionFactor = "1"> <UnitOfMeasure>PCE</UnitOfMeasure> </PriceBasisQuantity> <Classification domain = "not available">Material group 1</Classification> <Extrinsic name = "extLineNumber">10</Extrinsic> </ItemDetail> <ControlKeys> <OCInstruction value = "notAllowed"/> <ASNInstruction value = "notAllowed"/> <InvoiceInstruction value = "isNotERS" verificationType = "goodsReceipt"/> </ControlKeys> <ScheduleLine quantity = "10.0" requestedDeliveryDate = "2019-03-15T12:00:00+01:00" lineNumber = "1"> <UnitOfMeasure>PCE</UnitOfMeasure> </ScheduleLine> </ItemOut>

Valores de enmascaramiento en pedidos de compraAriba Network permite a las organizaciones compradoras enmascarar la cantidad, el importe y el precio al enviar un pedido de compra al proveedor. Estos valores tampoco se muestran cuando un proveedor crea una factura para el pedido de compra que contenga los valores enmascarados.

Las organizaciones compradoras pueden enmascarar valores en los siguientes tipos de pedidos de compra:

● Pedidos materiales● Pedidos globales● Pedidos de servicio

NotaSi un proveedor crea un artículo de factura para un artículo de pedido de compra global, los valores de cantidad y precio por unidad pueden editarse para el artículo de factura.

Para enmascarar estos valores, Ariba Network ha introducido el siguiente extrínseco que las organizaciones compradoras deben utilizar para enmascarar valores en los campos Importe, Cantidad y Precio por unidad en un pedido de compra:

● hideAmount: Un extrínseco que le permite enmascarar valores para el importe.● hideUnitPrice: Un extrínseco que le permite enmascarar valores para la cantidad y el precio por unidad.

Una organización compradora siempre puede ver todos los valores disponibles en un pedido de compra desde su cuenta del comprador Ariba Network. Si el pedido de compra contiene un valor enmascarado, aparece la cadena

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 173

Page 174: 355a de soluciones cXML - help.sap.com

"El pedido de compra contiene valores enmascarados para el proveedor". Si el pedido de compra se envía a través de cXML o se exporta mediante cXML, los valores enmascarados muestran un importe cero en los campos respectivos.

Para activar esta función, configure su adaptador (un adaptador Ariba Network o el suyo propio) para enviar el extrínseco necesario en el pedido de compra. Para obtener más información, consulte la Ariba NetworkGuía de administración del comprador.

El siguiente ejemplo muestra hideUnitPrice y hideAmount utilizados en la cabecera de un pedido:

<Request deploymentMode="production"> <OrderRequest> <OrderRequestHeader orderDate="2017-10-26T07:09:06-07:00" orderID="DO12091956" orderType="regular" type="new"> <Total> <Money currency="USD">300</Money> </Total> <ShipTo> ... </ShipTo> <BillTo> ... </BillTo> ... <Extrinsic name="hideUnitPrice"/> <Extrinsic name="hideAmount"/> </OrderRequestHeader> ... </OrderRequest> </Request>

El siguiente ejemplo muestra hideUnitPrice y hideAmount utilizados en un artículo en línea de un pedido:

<ItemDetail> <UnitPrice> <Money currency="USD">11</Money> </UnitPrice> <Description xml:lang="en">BULLNOSE SHELVES 4 PK</Description> <UnitOfMeasure>PK</UnitOfMeasure> <Classification domain="SPSC">foo</Classification> <ManufacturerPartID>AX4518</ManufacturerPartID> <ManufacturerName>20008496</ManufacturerName> <Extrinsic name="hideUnitPrice"/> <Extrinsic name="hideAmount"/> </ItemDetail>

Enmascaramiento a nivel de cabecera y a nivel de línea [página 175]

Extrínseco AmountBasedReceiving [página 176]

Extrínseco ContingencyReceiving [página 176]

Extrínseco InformationReceiving [página 177]

Atributo de Currency de Money [página 177]

Elemento de modificaciones [página 177]

Elemento TermsofDelivery [página 178]

Elemento PriceBasisQuantity [página 178]

Elemento Tolerancias [página 178]

Elemento ScheduleLine [página 180]

174PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 175: 355a de soluciones cXML - help.sap.com

Asignación de código de divisa de Ariba Network [página 181]

Enmascaramiento a nivel de cabecera y a nivel de línea

Los extrínsecos hideAmount y hideUnitPrice pueden aplicarse para enmascarar valores a nivel de cabecera y de línea.

Las organizaciones compradoras pueden incluir los extrínsecos hideUnitPrice y hideAmount a nivel de cabecera o línea, dependiendo del tipo de pedido:

● Pedidos materiales y pedidos globales: Los extrínsecos hideUnitPrice y hideAmount pueden incluirse en el nivel de cabecera, de línea o ambos. Si uno o ambos extrínsecos se han especificado a nivel de cabecera, los valores se enmascaran en el nivel de cabecera y de todos los artículos en línea del pedido de compra. Si los extrínsecos se especifican solo a nivel de artículo en línea, se enmascaran los valores para ese artículo en línea en particular.

● Pedidos de servicio: Los extrínsecos hideUnitPrice y hideAmount deben incluirse a todos los niveles de la jerarquía de pedidos de servicio (primarios y secundarios). Los precios por unidad no se ocultarán si los artículos primarios tienen los extrínsecos hideUnitPrice y hideAmount, y los artículos secundarios, no.

La siguiente tabla muestra los campos que están enmascarados cuando los extrínsecos hideAmount y hideUnitPricese especifican a nivel de cabecera o de artículo en línea para un pedido de compra:

Extrínseco acti­vado Valores enmascarados en un pedido de compra

Nivel de cabe­cera - Importe y precio por uni­dad

Importe disponi­ble

Subtotal Importe máximo Importe mínimo Estado Precio

Nivel de cabe­cera - Precio por unidad

- - - - Estado Precio

Nivel de cabe­cera - Importe

Importe disponi­ble

Subtotal Importe máximo Importe mínimo Estado -

Nivel de línea – Importe y precio por unidad

Importe disponi­ble

Subtotal Importe máximo Importe mínimo Estado Precio

Nivel de línea – Precio por uni­dad

- - - - Estado Precio

Nivel de línea – Importe

Importe disponi­ble

Subtotal Importe máximo Importe mínimo Estado -

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 175

Page 176: 355a de soluciones cXML - help.sap.com

Extrínseco AmountBasedReceiving

Los artículos en línea que contienen el elemento extrínseco AmountBasedReceiving con el valor "Yes" se consideran artículos en línea basados en importe. Los artículos en línea basados en importe se pueden utilizar en pedidos de compra para servicios y sólo es necesario especificar el importe total que el comprador esperar gastar.

Cuando un proveedor factura un artículo en línea basado en importe, los valores Cantidad, Unidad y Precio por unidad no se visualizan. Los proveedores pueden introducir importes parciales para artículos en línea basados en importe parcialmente facturados.

Ejemplo

<ItemDetail> <UnitPrice> <Money alternateCurrency="" alternateAmount="" currency="USD">200</Money> </UnitPrice> <Description xml:lang=“en”>IT Services</Description> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="unspsc">76</Classification> <LeadTime>0</LeadTime> <Extrinsic name="AmountBasedReceiving">Yes</Extrinsic> </ItemDetail>

NotaLos artículos en línea no se consideran basados en importe si el elemento extrínseco AmountBasedReceiving no se ha especificado. Por consiguiente, es incorrecto utilizar el elemento extrínseco AmountBasedReceiving con el valor "No".

Extrínseco ContingencyReceiving

Los artículos en línea que contienen el extrínseco ContingencyReceiving con el valor "Yes" se consideran artículos en línea de contingencia. Los artículos en línea de contingencia se pueden utilizar en pedidos de compra para servicios y este tipo de línea describe un servicio que no es esencial para llevar a cabo un pedido de compra. El valor de la línea de contingencia se incluye en el valor total de la Bill of Services (BOS) sólo si se activa el artículo en línea de contingencia mientras se crea una hoja de entrada de servicios o una factura.

Ejemplo

<ItemDetail> -<UnitPrice><Money currency="USD">50</Money></UnitPrice><Description xml:lang="en">bulldozer driverb</Description><UnitOfMeasure>HUR</UnitOfMeasure>

176PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 177: 355a de soluciones cXML - help.sap.com

<Classification domain="SPSC">foo</Classification><ManufacturerPartID>AX4518</ManufacturerPartID><ManufacturerName>20008496</ManufacturerName> <Extrinsic name="ContingencyReceiving">Yes</Extrinsic> </ItemDetail>

Extrínseco InformationReceiving

Los artículos en línea que contienen el extrínseco InformationReceiving con el valor "Yes" se consideran líneas de servicio de información. Las líneas de servicio de información sólo se usan para almacenar información adicional; las hojas de entrada de servicios y las facturas no se pueden crear contra líneas de servicio de información.

Ejemplo

<ItemDetail> -<UnitPrice><Money currency="USD">3000</Money></UnitPrice><Description xml:lang="en">bulldozer minia</Description><UnitOfMeasure>PK</UnitOfMeasure><Classification domain="SPSC">foo</Classification><ManufacturerPartID>AX4518</ManufacturerPartID><ManufacturerName>20008496</ManufacturerName> <Extrinsic name="InformationReceiving">Yes</Extrinsic> </ItemDetail>

Atributo de Currency de Money

El atributo currency es un código de divisa de tres letras ISO 4217 estándar que indica cómo interpretar el valor monetario expresado en el elemento Money.

<Money currency="USD">1.34</Money>

Encontrará más información en Sistemas de codificación recomendados [página 422].

Elemento de modificaciones

El elemento Modification contiene detalles de las deducciones y los cargos aplicables a artículos en línea. El elemento Modifications está envuelto por un elemento ItemDetail.

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 177

Page 178: 355a de soluciones cXML - help.sap.com

Elemento TermsofDelivery

El elemento TermsOfDelivery especifica las condiciones de entrega de un pedido de compra o un aviso de expedición.

Elemento PriceBasisQuantity

El elemento PriceBasisQuantity contiene la determinación de precios basada en la cantidad para un artículo en línea. La determinación de precios basada en la cantidad permite calcular el precio por unidad de un artículo a partir de cantidades superiores a 1.

Además de la determinación de precios basada en la cantidad, la determinación de precios mediante conversión de unidades permite la conversión de la unidad de medida en el cálculo de la determinación de precios si la unidad de medida del pedido es distinta de la unidad de medida de la determinación de precios. PriceBasisQuantity se rellena en el cXML de destino solo si la longitud de la cadena del elemento es PriceUnit mayor que cero.

Ejemplo

<ItemDetail> <UnitPrice> <Money currency="USD">0.10</Money> </UnitPrice> <Description xml:lang="en">ACME Push Pins; Clear; Box Of 20</Description> <UnitOfMeasure>EA</UnitOfMeasure> <PriceBasisQuantity quantity = "2" conversionFactor = "0.10"> <UnitOfMeasure>BX</UnitOfMeasure> <Description xml:lang = "en">This field specifies that 1 Box is equivalent to 10 EA and unit price is for 2 Boxes</Description> </PriceBasisQuantity>

NotaEste elemento se puede utilizar en pedidos de compra globales pero no en pedidos de compra de servicio.

Elemento Tolerancias

El elemento Tolerances, disponible para los compradores en Ariba Network, les permite especificar límites de precio máximo para los artículos en línea de un pedido de compra, así como límites de cantidad mínima y máxima y límites de fecha de entrega a nivel de cabecera de pedido de compra y de artículo en línea.

Los compradores pueden especificar tolerancias de artículos en línea para pedidos de compra individuales o diferentes en un pedido de compra que envían desde sus sistemas ERP. Las tolerancias de artículos en línea especificadas en el pedido de compra tiene mayor prioridad sobre las tolerancias de artículos en línea especificadas en la página Reglas de transacción predeterminadas de la cuenta de Ariba Network. Las

178PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 179: 355a de soluciones cXML - help.sap.com

tolerancias especificadas en el pedido de compra se aplican cuando un proveedor crea confirmaciones de pedido, avisos de expedición u hojas de entrada de servicios frente al pedido de compra.

Las tolerancias se aplican independientemente en cada documento que envía el proveedor. No se aplican acumulativamente en todas las confirmaciones de pedido, los avisos de expedición o las hojas de entrada de servicios para el mismo pedido de compra.

Cuando un comprador envía un pedido de compra cambiado que contenga la tolerancia de cantidad de artículo en línea, esta tolerancia toma preferencia por delante de la especificada en el pedido de compra original. Cuando el pedido cambiado no especifica ningún valor de tolerancia de cantidad de artículo en línea, se aplica la cantidad especificada en el pedido de compra cambiado o el valor de tolerancia especificado en la página Reglas de transacción predeterminadas.

Si la tolerancia de cantidad de artículo en línea especificada en el pedido de compra cambiado es menor que la cantidad de artículo en línea total que se puede expedir, Ariba Network no le permite expedir más artículos para el pedido de compra.

Para enviar un pedido de compra con tolerancias de artículos en línea, el documento cXML OrderRequest debe contener el elemento Tolerances . El elemento Tolerances tiene los siguientes elementos:

Elemento Descripción

QuantityTolerance La tolerancia de cantidad de un artículo en línea. Este elemento tiene los elementos siguientes:

● Percentage: El porcentaje de la tolerancia de cantidad.● Value: El número de cantidad de la tolerancia de cantidad.

Puede especificar uno de estos elementos en el elemento QuantityTolerance .

PriceTolerance La tolerancia de precio de un artículo en línea. Este elemento tiene los elementos si­guientes:

● Percentage: El porcentaje de la tolerancia de precio.● Money: El importe y la divisa de la tolerancia de precio.

Puede especificar uno de estos elementos en el elemento PriceTolerance .

TimeTolerance La tolerancia de fecha de entrega de un artículo en línea. Este elemento tiene los atri­butos siguientes:

● limit (obligatorio): El límite de tolerancia de la fecha de entrega.● type: El tipo del límite temporal. Los valores posibles son: minutes, hours,

days (valor predeterminado) y weeks. Por lo general se recomiendan los valo­res days o weeks para especificar tolerancias de fechas de entrega.

Las tolerancias de cantidad y de fecha de entrega deben incluirse en los elementos Lower y Upper para definir tolerancias mínimas y máximas.

Ejemplo: Tolerancias de cantidad, precio y tiempo

<ItemOut> <Tolerances> <QuantityTolerance>

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 179

Page 180: 355a de soluciones cXML - help.sap.com

<Percentage percent = "12"/> </QuantityTolerance> <PriceTolerance> <Money currency="USD">200</Money> </PriceTolerance> <TimeTolerance limit="5" /> </Tolerances> </ItemOut>

Tolerancias de cantidad inferior y superior

<ItemOut> <ControlKeys> <OCInstruction value="allowed"> <Lower> <Tolerances> <QuantityTolerance> <!-- underdelivery of up to 5 units allowed --> <Value value="5" /> </QuantityTolerance> <TimeTolerance limit="5"/> </Tolerances> </Lower> <Upper> <Tolerances> <QuantityTolerance> <!-- up to 10% overdelivery allowed --> <Percentage percent="10" /> </QuantityTolerance> <TimeTolerance limit="5"/> </Tolerances> </Upper> </OCInstruction> <…> </ControlKeys></ItemOut>

Información relacionada

Guía de administración del comprador de Ariba Network

Elemento ScheduleLine

El elemento ScheduleLine especifica información relacionada con los planes de entrega para un artículo en línea. Un artículo en línea puede tener un máximo de 50 líneas de programación.

180PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 181: 355a de soluciones cXML - help.sap.com

ScheduleLine ajusta un elemento UnitOfMeasure y tiene los atributos siguientes:

Atributo Descripción

quantity Cantidad de artículos por expedir.

Este es un campo obligatorio.

requestedDeliveryDate Fecha en la que se espera que se entregue la cantidad especificada

Este es un campo obligatorio.

deliveryWindow (opcional) Duración de tiempo en que se espera que se entregue la cantidad.

lineNumber (opcional) Un número de línea se puede agregar como identificador de línea para una línea de programación específica.

Asignación de código de divisa de Ariba Network

Utilice los códigos de divisa de tres caracteres ISO 4217 (CodeA) para especificar tipos de divisa en cXML. Ariba Network reconoce algunos códigos que antes estaban admitidos que ahora son obsoletos y los convierte en sus nuevos códigos.

Cuando Ariba Network recibe pedidos de compra, convierte los siguientes códigos de divisa obsoletos en códigos actualizados:

Código obsoleto Código actual

ARP ARS

ARA ARS

BGL BGN

BRE BRL

BRR BRL

CAN CAD

CDN CAD

IRL IEP

MXP MXN

PLZ PLN

RUB RUR

Si utiliza códigos de divisa obsoletos en catálogos o en Ariba Buyer, cámbielos por los códigos actualizados.

Ariba Network asigna los importes que no tienen ninguna divisa especificada a USD.

NotaAriba Network no convierte el código de divisa para cuentas de prueba.

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 181

Page 182: 355a de soluciones cXML - help.sap.com

Información relacionada

Códigos de divisa [página 423]

Pedidos de cancelación y pedidos de cambio

Los pedidos de cancelación y los pedidos de cambio son pedidos de compra enviados por las organizaciones compradoras que modifican los pedidos de compra enviados anteriormente.

Requisitos de pedidos de cancelación y de cambio [página 182]

Requisitos de pedidos de cancelación y de cambio para organizaciones compradoras [página 182]

Requisitos de pedidos de cancelación y de cambio para proveedores [página 183]

Pedidos de cancelación y cambio y estado de pedido [página 183]

Coincidencia de pedidos de compra [página 183]

Pedidos de cancelación [página 184]

Requisitos de pedidos de cancelación y de cambio

Para que una organización compradora pueda enviar pedidos de cancelación o de cambio deben cumplirse los requisitos especificados relativos a las capacidades de las organizaciones compradoras, el estado del pedido y la coincidencia del pedido de compra.

Requisitos de pedidos de cancelación y de cambio para organizaciones compradoras

La utilización de pedidos de cancelación y de cambio depende de los procesos empresariales de las organizaciones compradoras. Las organizaciones compradoras pueden activar o desactivar la generación de estos pedidos en Ariba Buyer y en Ariba Network.

De forma predeterminada, Ariba Network no permite a las organizaciones compradoras cancelar o cambiar un pedido de compra marcado como Expedido o Parcialmente expedido. Sin embargo, Ariba Network tiene reglas configurables por el comprador para permitir pedidos de cancelación o de cambio para pedidos de compra expedidos o expedidos parcialmente. Los proveedores pueden ver estas reglas.

182PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 183: 355a de soluciones cXML - help.sap.com

Ariba Network permite a las organizaciones compradoras cambiar un pedido de compra de servicios marcado como Servido parcialmente con las restricciones siguientes:

Estado del pedido de com­pra Cambios permitidos

Nuevo Los compradores pueden efectuar cualquier actualización excepto cambiar una línea de servicio (requiresServiceEntry=”yes”) por una línea de no servicio o viceversa. Las líneas de servicio deben continuar siendo líneas de servicio y las líneas de no servicio, líneas de no servicio en cualquier cambio que se efectúe en pedidos existentes.

Servido parcialmente ● Los compradores no pueden cambiar líneas de servicio a líneas de no servicio o viceversa en ningún momento.

● Los compradores pueden agregar tanto líneas de servicio como líneas de bienes materiales.● Los compradores pueden editar o suprimir tanto líneas de servicio como líneas de bienes

materiales contra las que se han creado hojas de entrada de servicios, se hayan aprobado o no.

Los compradores pueden actualizar importes de pedidos de compra o de líneas en pedidos de servicio para proyectos que exceden el presupuesto inicial, de modo que los proveedores pueden continuar creando hojas de entrada de servicios contra estos hasta que finalice el proyecto.

Los proveedores pueden crear nuevas hojas de entrada de servicios contra pedidos de compra cambiados. Sólo pueden facturar líneas de servicio aprobadas si el comprador no las ha eliminado del pedido base.

Requisitos de pedidos de cancelación y de cambio para proveedoresLos proveedores pueden configurar sus cuentas Ariba Network para enrutar pedidos de cancelación y de cambio de forma distinta desde nuevos pedidos de compra.

Pedidos de cancelación y cambio y estado de pedidoCuando Ariba Network recibe pedidos de cambio, restablece los estados de pedido al estado inicial. Esto descarta cualquier estado fijado previamente para esos pedidos.

Encontrará información sobre la interacción entre estos pedidos y las confirmaciones y los avisos de expedición en Confirmaciones y pedidos de cancelación [página 233] y Avisos de expedición y pedidos de cancelación y de cambio [página 248].

Coincidencia de pedidos de compraCada pedido de cancelación y de cambio hace referencia a la versión previa del pedido a través de un elemento DocumentReference que contiene el payloadID de la versión previa del pedido.

Ariba Network verifica si esa referencia es válida y rechaza el pedido de cancelación o de cambio si ninguno de los pedidos existentes coincide.

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 183

Page 184: 355a de soluciones cXML - help.sap.com

Pedidos de cancelación

Las organizaciones compradoras utilizan pedidos de cancelación para cancelar pedidos de compra enviados previamente. Ariba Network muestra el estado de un pedido de compra cancelado como “Obsoleto.”

Los pedidos de cancelación son iguales que los pedidos de compra regulares excepto en los siguientes aspectos:

● El elemento OrderRequestHeader tiene el atributo type="delete" en lugar de "new" y el atributo orderVersion del pedido original (Ariba Buyer 8.1 y posteriores).

● El elemento OrderRequestHeader DocumentReference puede contener el payloadID de la OrderRequest anterior.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd"><cXML payloadID="[email protected]" timestamp="2003-03-28T13:04:04-08:00"> <Header> <From> <Credential domain="NetworkID"> <Identity>AN01000002792</Identity> </Credential> </From> <To> <Credential domain="DUNS"> <Identity>623331717</Identity> </Credential> </To> <Sender> <Credential domain="BuyerNetworkUserId"> <Identity>[email protected]</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Ariba Buyer 8.1</UserAgent> </Sender> </Header> <Request> <OrderRequest> <OrderRequestHeader orderDate="2003-03-28T13:04:04-08:00" orderID="PCO66" type="delete" orderVersion="3"> <DocumentReference payloadID="[email protected]"/> . . . Order details are included by Ariba Buyer, but are ignored by Ariba Network . . . </OrderRequest> </Request> </cXML>

184PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 185: 355a de soluciones cXML - help.sap.com

Encontrará información sobre la interacción entre estos pedidos y las confirmaciones y los avisos de expedición en Confirmaciones y pedidos de cancelación [página 233] y Avisos de expedición y pedidos de cancelación y de cambio [página 248].

Pedidos de cambioLas organizaciones compradoras utilizan pedidos de cambio para modificar pedidos de compra enviados previamente. Cada documento OrderRequest actualizado sustituye la versión previa de ese documento. En otras palabras, la versión previa del documento se descarta. Las actualizaciones no se acumulan.

Los pedidos de cambio son iguales que los pedidos de compra regulares excepto en los siguientes aspectos:

● El elemento OrderRequestHeader tiene el atributo type="update" en lugar de "new".● El elemento OrderRequestHeader DocumentReference puede contener el payloadID de la

OrderRequest anterior.

Ariba Buyer 8.0 y anteriores utiliza un mecanismo distinto para indicar versiones de pedido de Ariba Buyer 8.1 y posteriores.

Pedidos de cambio en Ariba Buyer 8.0 y anterioresEn Ariba Buyer 8.0 y anteriores, un pedido de cambio se indica añadiendo -Vn al orderID de una versión de pedido anterior. Así por ejemplo, orderID="PC066-V2” es la primera revisión del pedido de compra original PC066. El número de versión “1” corresponde al pedido original y se va incrementando para cada pedido de cambio posterior.

Ariba Buyer 7.0.6 corrigió un problema menor en pedidos de cambio cXML. Encontrará más información en Cambios introducidos por Ariba Buyer 7.0.6 [página 213].

Pedidos de cambio en Ariba Buyer 8.1 y posterioresAriba Buyer 8.1 y posteriores emplean cXML 1.2009 con atributos OrderRequestHeader para insertar información sobre la versión del pedido que permita hacer un mejor seguimiento de las versiones a los sistemas receptores.

Los atributos OrderRequestHeader incluyen:

● orderVersionEspecifica la versión del pedido del sistema comprador y sólo es aplicable cuando la OrderRequest constituye una solicitud de pedido de cambio. El número de versión para el pedido de compra original debe ser 1 e irse incrementando de uno en uno para cada versión posterior.Ariba Network valida el número orderVersion. Este número debe ser unívoco para cada versión del pedido de compra y debe ser ascendente (desde el pedido original al pedido de cambio más reciente). Ariba Network no permite versiones duplicadas o en orden descendente.

● isInternalVersionIndica si el cambio es relevante únicamente dentro de la organización compradora. Por ejemplo si se ha

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 185

Page 186: 355a de soluciones cXML - help.sap.com

efectuado un pequeño cambio que no afecta a la información utilizada por el proveedor. Puede que los proveedores no vean versiones de pedido internas en función de su configuración como clientes.

Ejemplo

<OrderRequestHeader orderDate="2005-03-28T13:04:04-08:00" orderID="DO166" type="update" orderVersion="3" isInternalVersion="yes"> <DocumentReference payloadID="[email protected]"/>

Este pedido es un pedido de cambio (type="update"). Se trata de la segunda revisión del pedido original (orderVersion="3"). Es una versión interna, de modo que los cambios efectuados no son relevantes para el proveedor (isInternalVersion="yes").

Consejos de implementación y restricciones para pedidos de compraCuando implemente sus aplicaciones para pedidos de compra cXML debe prestar atención a las recomendaciones y posibles restricciones.

Elementos de credencial [página 187]

Funciones de contacto [página 187]

Dirección Vendido a y NIF/CIF [página 188]

Ruta y copias de pedido [página 188]

Divisiones de contabilidad para los pedidos de copia ERP [página 189]

Artículos no incluidos en el catálogo [página 190]

Información introducida por el usuario para artículos por encargo [página 190]

Activación o desactivación de pedidos por encargo [página 191]

Detección de pedidos por encargo [página 191]

Desglose de solicitudes en varias solicitudes de pedido [página 191]

Grupos de artículos y artículos agrupados en pedidos de servicios [página 191]

Hojas de entrada de servicios [página 192]

Tarjetas de compra [página 192]

Pedidos de compra global [página 192]

Pedido de subcontratación [página 192]

Incoterms en pedidos [página 200]

Extrínseco AribaNetwork.PaymentTermsExplanation [página 201]

186PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 187: 355a de soluciones cXML - help.sap.com

Información relacionada

Tamaño máximo de documentos y adjuntos [página 22]Extrínsecos para enlaces en los que se puede hacer clic [página 211]Extrínseco para pedidos de compra heredados [página 212]Cambios introducidos por Ariba Buyer 7.0.6 [página 213]

Elementos de credencial

Los elementos cXML Credential en la cabecera de cada documento cXML identifican las organizaciones remitentes y destinatarias.

Encontrará información detallada sobre las credenciales utilizadas en documentos OrderRequest en Acerca de credenciales cXML [página 44].

Para obtener más información acerca de las restricciones de credenciales de versiones anteriores de Ariba Buyer, consulte ID de Ariba Network y versiones anteriores de Ariba Buyer [página 47].

Funciones de contacto

De forma predeterminada, los documentos OrderRequest utilizan los elementos BillTo y ShipTo para especificar direcciones de facturación y de expedición. En algunos casos es posible que los socios comerciales quieran proporcionar direcciones adicionales.

Si las organizaciones compradoras generan documentos OrderRequest, pueden utilizar la sección opcional Contact para especificar múltiples funciones y direcciones.

Ariba Network reconoce los siguientes valores de la función Contact en los pedidos de compras:

Valor de la función de contacto Se muestra como

postDelivery Dirección postal

cargoDelivery Dirección de cargo

companyDelivery Recepción

privateEndUser Dirección del solicitante

defaultDelivery Dirección de entrega personal

buyerCorporate Dirección de la sede del comprador

supplierCorporate Dirección del proveedor

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 187

Page 188: 355a de soluciones cXML - help.sap.com

Valor de la función de contacto Se muestra como

soldTo Cliente

NotaLa acción de pasar información "Vendido a" dentro de un elemento Contact está en desuso. En su lugar, utilice el elemento BusinessPartner [página 154].

Dirección Vendido a y NIF/CIF

Ariba Network permite a los compradores configurar una lista de direcciones Vendido a y asociarlas a uno o varios NIF/CIF. Como práctica recomendada, SAP Ariba recomienda que los compradores que utilicen SAP Ariba Commerce Automation o SAP Ariba Invoice Management incluyan la dirección Vendido a y el NIF/CIF en el cXML del pedido de compra.

Al incluir la dirección Vendido a y el NIF/CIF en el pedido de compra, cXML elimina la necesidad de que el proveedor indique esta información en una posterior factura. Para agregar la dirección Vendido a, utilice el elemento Contact role. Para agregar el NIF/CIF, agregue el extrínseco buyervatID al OrderRequestHeader:

<Extrinsic name="buyerVatID">SE123456789087</Extrinsic>

Cuando un proveedor crea una factura con pedido o sin pedido, Ariba Network visualiza la lista y permite al proveedor seleccionar una dirección. Si un NIF/CIF está asociado a la dirección, Ariba Network la visualiza en la factura.

Ruta y copias de pedido

Los agregadores de proveedores o los hosts del Marketplace que deseen recibir copias de pedidos de compra, pero que no son los destinatarios principales, deben usar la ruta cXML. Estas organizaciones se denominan organizaciones de copia.

Las organizaciones de copia deben llevar a cabo los pasos siguientes para prepararse para la ruta:

1. Las organizaciones de copia deben informar a las organizaciones de compra que agreguen información de ruta a todos los documentos PunchOutSetupRequest y OrderRequest. Por ejemplo:

<Path> <Node type="copy"> <Credential domain="NetworkID"> <Identity>AN01000000111</Identity> </Credential> </Node> </Path>

2. Las organizaciones de copia deben agregar la transacción CopyRequest a su perfil cXML.

Cuando Ariba Network recibe un pedido de compra que contiene información de copia de ruta, primero busca la URL de la CopyRequest de la solicitud de copia en el perfil cXML de la organización. Si la organización no tiene un perfil cXML o si CopyRequest no aparece en su perfil, Ariba Network intenta enviar la OrderRequest de copia a la

188PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 189: 355a de soluciones cXML - help.sap.com

URL de la organización introducida en el campo "URL para enviar los pedidos" en la página Método para recibir pedidos en el área de configuración de la cuenta.

Divisiones de contabilidad para los pedidos de copia ERPSi su sitio permite las divisiones de contabilidad, puede agregar distribuciones de contabilidad a los artículos en línea de un pedido de copia ERP para dividir los importes entre distintas unidades de contabilidad de una organización.

En el siguiente ejemplo se muestra un artículo en línea con divisiones de contabilidad por porcentaje para un pedido de copia ERP:

<ItemOut quantity="100.000" lineNumber="00001" requestedDeliveryDate="2020-01-20T00:00:0005:45"> <ItemID> <SupplierPartID>Non Catalog Item</SupplierPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">10</Money> </UnitPrice> <Description xml:lang="EN">1st line</Description> <UnitOfMeasure>EA</UnitOfMeasure> <PriceBasisQuantity quantity="1" conversionFactor="1"> <UnitOfMeasure>EA</UnitOfMeasure> </PriceBasisQuantity> <Classification domain="NotAvailable">00801</Classification> <Extrinsic name="AccountCategory">K</Extrinsic> <Extrinsic name="ReceivingType">4</Extrinsic> </ItemDetail> <Distribution> <Accounting name="DistributionCharge"> <AccountingSegment id="0000400000"> <Name xml:lang="en">GeneralLedger</Name> <Description xml:lang="en"/> </AccountingSegment> <AccountingSegment id="0000001200"> <Name xml:lang="en">CostCenter</Name> <Description xml:lang="en"/> </AccountingSegment> <AccountingSegment id="60.00"> <Name xml:lang="en">Percentage</Name> <Description xml:lang="en"/> </AccountingSegment> </Accounting> <Charge> <Money currency="USD">600.00</Money> </Charge> </Distribution> <Distribution> <Accounting name="DistributionCharge"> <AccountingSegment id="0000400000"> <Name xml:lang="en">GeneralLedger</Name> <Description xml:lang="en"/> </AccountingSegment> <AccountingSegment id="0000001200"> <Name xml:lang="en">CostCenter</Name> <Description xml:lang="en"/> </AccountingSegment> <AccountingSegment id="40.00"> <Name xml:lang="en">Percentage</Name> <Description xml:lang="en"/>

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 189

Page 190: 355a de soluciones cXML - help.sap.com

</AccountingSegment> </Accounting> <Charge> <Money currency="USD">400.00</Money> </Charge> </Distribution> </ItemOut>

NotaEn SAP Ariba Invoice Management, si el pedido asociado es un pedido de copia ERP, deberá dividir las distribuciones de contabilidad por porcentaje. No se admite la división por importe o cantidad si el pedido es un pedido de copia ERP.

Información relacionada

Elemento Accounting [página 160]Ruta y copias de pedido [página 188]

Artículos no incluidos en el catálogo

Los pedidos de compra por encargo contienen artículos en línea descritos manualmente por los solicitantes y no artículos seleccionados a partir de catálogos electrónicos. Los solicitantes introducen estos artículos en una base por encargo porque no los encontraron en los catálogos electrónicos.

A menudo, los artículos por encargo no tienen números de pieza. Los pedidos de compra que contienen artículos por encargo normalmente requieren una validación y un procesamiento especiales, por lo que no todos los proveedores pueden aceptarlos.

Información introducida por el usuario para artículos por encargo

Los artículos por encargo deben incluir información específica introducida por el usuario.

La información de artículos por encargo debe incluir:

● ID de parte del proveedor (opcional)● Descripción● Código de mercancía● Cantidad● Unidad de medida● Precio por unidad

Los proveedores deben validar con cuidado esta información, porque no proviene de sus catálogos electrónicos.

190PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 191: 355a de soluciones cXML - help.sap.com

Activación o desactivación de pedidos por encargo

Las organizaciones compradoras determinan si sus usuarios pueden pedir artículos por encargo. Los proveedores deben ponerse en contacto con sus clientes para determinar si permiten pedidos que contengan artículos por encargo.

Los proveedores pueden configurar sus cuentas Ariba Network para enrutar los pedidos que contengan artículos por encargo de forma diferente que los pedidos regulares o para rechazar esos pedidos.

Detección de pedidos por encargo

Para detectar artículos por encargo, Ariba Network examina los pedidos entrantes y busca la marca isAdHoc (Ariba 8.0 y posteriores) o IDs de piezas de proveedor que están en blanco o fijadas como “not available”.

Ariba Buyer no utiliza la marca isAdHoc para artículos de catálogo regulares.

Desglose de solicitudes en varias solicitudes de pedido

Ariba Buyer debería configurarse para desglosar solicitudes que contienen tanto artículos de catálogo y artículos por encargo en pedidos de compra separados. En ese caso, los proveedores podrán procesar automáticamente tantos artículos de solicitud como sea posible en lugar de tener que procesar manualmente los artículos de catálogo y los artículos por encargo.

Grupos de artículos y artículos agrupados en pedidos de servicios

En pedidos de compra con varios niveles (grupos de artículos que contienen artículos agrupados), las líneas de servicio pueden ser líneas individuales, grupos de artículos o artículos agrupados. Ariba Network no admite líneas de servicio en un grupo de artículos que no sean de servicio.

Las líneas de servicio se pueden agrupar dentro de un grupo de artículos de servicio. Por ejemplo:

Permitido: No permitido:

● 1 Artículo en línea de servicio A (grupo de artículos)○ 1.1 Artículo en línea de bienes A1 (artículo agrupado)○ 1.2 Artículo en línea de bienes A2 (artículo agrupado)

● 2 Artículo en línea de servicio B (grupo de artículos)○ 2.1 Artículo en línea de bienes B1 (artículo agrupado)○ 2.2 Artículo en línea de servicio B2 (artículo agrupado)

● 3 Artículo en línea de servicio C (línea individual)● 4 Artículo en línea de bienes D (línea individual)

● 1 Artículo en línea de bienes A (grupo de artículos)○ 1.1 Artículo en línea de servicio A1 (artículo agru­

pado)

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 191

Page 192: 355a de soluciones cXML - help.sap.com

Hojas de entrada de servicios

Ariba Network requiere que los proveedores creen uno o más documentos de hoja de entrada de servicios para cualquier línea de un pedido de compra con un atributo ItemOut que incluya el atributo requiresServiceSheet="yes".

Las hojas de entrada de servicios pueden incluir líneas de bienes de material y de servicios. El proveedor utiliza las hojas de entrada de servicios para describir los servicios tal y como se realizan, y también las utiliza como base para las facturas. Consulte Hojas de entrada de servicios [página 252].

Tarjetas de compra

Las organizaciones compradoras pueden incluir el elemento PCard en el elemento OrderRequestHeader para proporcionar información de la tarjeta de compra a los proveedores. Los proveedores pueden modificar las tarjetas de compra mediante sus propios sistemas de punto de venta.

Pedidos de compra global

Soluciones de SAP Ariba Procurement sólo soporta pedidos de compra globales de nivel de artículo procedentes de sistemas ERP externos.

Cuando Soluciones de SAP Ariba Procurement recibe cualquier otro tipo de pedido de compra global desde un sistema ERP, este es aceptado por la solución SAP Ariba y el tipo de contrato especificado en el archivo cXML del pedido de compra global entrante (en el elemento extrínseco ContractType) se refleja correctamente en la solución SAP Ariba, pero el pedido de compra global no funciona de acuerdo con su tipo de contrato. Así por ejemplo, las condiciones de determinación de precios se muestran como condiciones de determinación de precios de nivel de artículo si el pedido de compra global entrante es un contrato de proveedor.

NotaAriba Network no admite líneas de servicio (aquellas que requieren una hoja de entrada de servicios) en pedidos de compra globales.

Pedido de subcontratación

Un pedido de subcontratación es un pedido de compra que envía un comprador a un fabricante tercero para solicitar la producción y la entrega de los productos terminados.

El pedido de subcontratación no sólo transporta la información del nivel de artículo y del nivel de línea, sino también la información del componente de subcontratación. Los componentes de subcontratación son las materias primas que se utilizan para fabricar los productos terminados especificados en el nivel de artículo.

192PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 193: 355a de soluciones cXML - help.sap.com

Pedido de subcontratación

Los siguientes elementos y atributos se han agregado para ofrecer soporte a la colaboración de la fabricación a terceros.

Tabla 1: Elementos agregados para el pedido de subcontratación

Elemento Contenido en Descripción

SubcontractingComponent* ScheduleLine Contiene información detallada del compra­dor acerca de un componente de subcontra­tación que se utiliza para fabricar productos terminados. Por ejemplo, SubcontractingComponent no podía contener un ID, una descripción, un ID de pro­ducto de comprador, una cantidad ni la fecha necesaria.

ComponentID SubcontractingComponent Contiene un identificador de comprador para un componente de subcontratación en el pro­ceso de compra.

Product SubcontractingComponent Contiene información del producto para un componente de subcontratación, como un ID de producto de comprador, ID de producto de proveedor, ID de producto estándar o ID de producto interno.

ProductRevisionID SubcontractingComponent Contiene un identificador para un cambio es­pecífico realizado en un componente. Este es un número secuencial que está asignado cuando los cambios deban realizarse en un objeto.

Batch SubcontractingComponentItemOut

Contiene información de lote para material o bienes producidos en una ejecución de fabri­cación individual.

BuyerBatchID Batch Contiene un identificador de comprador para el material o los bienes producidos en una eje­cución de fabricación individual.

PropertyValuation Batch Contiene un valor que se puede asignar a ca­racterísticas, como por ejemplo valores de propiedad que pertenecen a importes de di­visa, cantidades o fechas. PropertyValuation incluye la propiedad que se debe evaluar y los valores asociados.

PropertyReference PropertyValuation Una referencia a la propiedad que se evalúa.

ValueGroup PropertyValuation Contiene un grupo de valores para una propie­dad que se evalúa.

ParentID ValueGroup Un identificador de su principal.

PropertyValue ValueGroup Propiedades para evaluar una propiedad.

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 193

Page 194: 355a de soluciones cXML - help.sap.com

Tabla 2: Atributos agregados para el pedido de subcontratación

Atributo Contenido en Descripción

itemCategory ItemOut Define cómo se proporciona un componente o material. Los valores posibles son subcontrato, consignación, o terceros.

code Characteristic Código asociado con una característica, como por ejemplo un código de divisa o una unidad de medida.

Mensaje de aviso de expedición de componente

Tabla 3: Elementos agregados para el aviso de expedición de componente

Elemento Contenido en Descripción

IdReference ItemID Contiene un grupo de valores que pertenecen a una propiedad. IdRReference se agregó a ItemID para hacer referencia a identificadores adicionales.

Batch ShipNoticeItem Contiene información de lote para material o bienes producidos en una ejecución de fabrica­ción individual.

Instantánea de inventario de componentes

Tabla 4: Elementos agregados para la instantánea de inventario de componentes

Elemento Contenido en Descripción

ProductActivityMessage n/a Transmite el inventario de componentes, el mo­vimiento de consignación e información de pre­visión desde el sistema ERP del comprador. La vista de resumen del inventario proporcionada por el comprador incluye los componentes de­clarados al proveedor. La información facilitada proporciona una instantánea del inventario de componentes y la situación de previsión en un determinado momento.

ProductActivityHeader ProductActivityMessage Contiene información sobre un inventario de componentes en concreto, los detalles de previ­sión del producto o un movimiento de consigna­ción para el producto.

ProductActivityDetails ProductActivityMessage Contiene los detalles sobre una actividad de producto.

194PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 195: 355a de soluciones cXML - help.sap.com

Elemento Contenido en Descripción

ItemID ProductActivityDetails Contiene información de identificación del artí­culo.

Batch ProductActivityMessage Contiene información de lote para material o bienes producidos en una ejecución de fabrica­ción individual.

Contact ProductActivityDetails El elemento de contacto contiene, en el atributo de función, el nombre de la planta en el punto de origen y el nombre de la planta en el destino.

Utilice el atributo de función y los elementos IdReference y Description para pasar información de planta.

IdReference Contact Puede pasar información de planta en IdReference configurando valores para los atributos de identificador y de dominio.

Description ProductActivityDetails NotaPara utilizar IdReference para pasar in­formación de planta, establezca el nombre de la planta en la descripción, como en el ejemplo siguiente:

<Description xml:lang="en">Sunnyvale - Plant1</Description>

Inventory ProductActivityDetails Contiene detalles acerca del stock de compo­nentes.

SubcontractingStockIn-TransferQuantity

Inventory Contiene información acerca de la cantidad y la unidad de medida.

Tabla 5: Atributos agregados para la instantánea de inventario de componentes

Atributo Contenido en Descripción

función Contact Si la función se establece en locationFrom o locationTo, la información de planta se puede pasar en IDReference.

Para utilizar Contact para el punto de origen, establezca role=locationFrom. Para utili­zar Contact para el destino, establezca role=locationTo.

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 195

Page 196: 355a de soluciones cXML - help.sap.com

Mensaje de recibo de componentes

Tabla 6: Atributos agregados para el mensaje de recepción de componentes

Atributo Contenido en Descripción

completedIndicator ReceiptItem Especifica si un artículo de aviso de expedición de componente se considera cerrado. Esto sig­nifica que no se esperan más recibos de com­ponentes para este artículo. Este atributo es un valor de paso y no se realiza ninguna validación en su contra en el back end.

lineNumber ReceiptItemReference En el escenario en el que OrderRequest está vacío, el número de línea hace referencia al shipNoticeLineNumber del aviso de expe­dición de componente, es decir, el aviso de ex­pedición referenciado en el ShipNoticeReference.

Consumo de materiales (toma retroactiva)

Tabla 7: Elementos agregados para el mensaje de consumo de materiales (toma retroactiva)

Elemento Contenido en Descripción

ComponentConsumption-Details

ShipNoticeItem Contiene detalles del consumo de materiales.

Consumo de materiales (tiempo real)

Tabla 8: Elementos agregados para el mensaje de consumo de materiales (tiempo real)

Elemento Contenido en Descripción

ComponentConsumptionRequest n/a Datos enviados por un proveedor al com­prador para informar acerca del con­sumo de materiales durante la fabrica­ción de un artículo pedido.

ComponentConsumptionHeader ComponentConsumptionRequest Contiene datos pertinentes a todas las porciones del consumo de materiales.

ComponentConsumptionPortion ComponentConsumptionRequest Contiene detalles de todos los consumos de materiales para una OrderRequest en concreto.

ComponentConsumptionItem ComponentConsumptionPortion Contiene detalles del pedido de compra para los materiales consumidos.

196PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 197: 355a de soluciones cXML - help.sap.com

Elemento Contenido en Descripción

ComponentConsumptionDetails ComponentConsumptionItem Contiene detalles acerca del consumo de materiales.

Ejemplo de pedido de subcontratación

El extracto siguiente de un pedido de subcontratación muestra un elemento ItemOut que contiene varios elementos SubcontractingComponent:

<ItemOut itemCategory="subcontract" requestedDeliveryDate="2008-09-21" quantity="100" lineNumber="1"> <ItemID> <SupplierPartID>AX4518-1</SupplierPartID> <SupplierPartAuxiliaryID>AXSPA001-1</SupplierPartAuxiliaryID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">31.20</Money> </UnitPrice> <Description xml:lang="en">Violin</Description> <UnitOfMeasure>PK</UnitOfMeasure> <Classification domain="SPSC">foo</Classification> <ManufacturerPartID>AX4518-1</ManufacturerPartID> <ManufacturerName>20008496-1</ManufacturerName> </ItemDetail> <Distribution> <Accounting name="DistributionCharge"> <Segment type="G/L Account" id="23456" description="Entertainment"/> <Segment type="Cost Center" id="2323" description="Western Region Sales"/> </Accounting> <Charge> <Money currency="USD">31.20</Money> </Charge> </Distribution> <ScheduleLine requestedDeliveryDate="2008-09-20T00:00:00-08:00" quantity="10" lineNumber="1"> <UnitOfMeasure>PK</UnitOfMeasure> <SubcontractingComponent quantity="1" requirementDate="2013-08-01T14:37:31-07:00"> <ComponentID>1</ComponentID> <UnitOfMeasure>BOX</UnitOfMeasure> <Description xml:lang="en">Fiddle Peg</Description> <Product> <SupplierPartID>SupplierPartID1</SupplierPartID> <SupplierPartAuxiliaryID>SupplierPartAuxiliaryID1</SupplierPartAuxiliaryID> <BuyerPartID>BuyerPartID1</BuyerPartID> <IdReference domain="StandardID" identifier="1000"/> <IdReference domain="InternalID" identifier="2000"/> </Product> <ProductRevisionID>12345</ProductRevisionID> <Batch originCountryCode="US" expirationDate="2014-06-10T14:37:31-07:00" productionDate="2013-06-10T14:37:31-07:00"> <BuyerBatchID>BuyerBatchID1</BuyerBatchID> <SupplierBatchID>SupplierBatchID1</SupplierBatchID> <PropertyValuation> <PropertyReference> <IdReference domain="ID" identifier="Image"/>

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 197

Page 198: 355a de soluciones cXML - help.sap.com

</PropertyReference> <ValueGroup> <PropertyValue name="BinarySpecification"> <Characteristic domain="BinaryObject" value="AQIDBAUGBwgJAA=="/> <Characteristic domain="mimeCode" value="x-world/x-3dmf"/> <Characteristic domain="characterSetCode" value="ASCII"/> <Characteristic domain="format" value="netCDF"/> <Characteristic domain="fileName" value="binaryData"/> <Characteristic domain="uri" value="http://sap.com/anyURI"/> </PropertyValue> <PropertyValue name="DateTimeSpecification"> <Characteristic domain="DateTime" value="1999-05-31T13:20:00Z"/> <Characteristic domain="timeZoneCode" value="PST"/> <Characteristic domain="daylightSavingTimeIndicator" value="true"/> </PropertyValue> <PropertyValue name="AmountSpecification"> <Characteristic domain="Amount" value="200" code="USD"/> <Characteristic domain="LowerAmount" value="100" code="EUR"/> <Characteristic domain="UpperAmount" value="300" code="EUR"/> </PropertyValue> <PropertyValue name="QuantitySpecification"> <Characteristic domain="Quantity" value="200" code="BOX"/> <Characteristic domain="LowerQuantity" value="100" code="EA"/> <Characteristic domain="UpperQuantity" value="300" code="EA"/> </PropertyValue> </ValueGroup> </PropertyValuation> <PropertyValuation> <PropertyReference> <IdReference domain="ID" identifier="Price"/> </PropertyReference> <ValueGroup> <PropertyValue name="DateTimeSpecification"> <Characteristic domain="DateTime" value="1999-05-31T13:20:00Z"/> <Characteristic domain="timeZoneCode" value="PST"/> <Characteristic domain="daylightSavingTimeIndicator" value="true"/> </PropertyValue> <PropertyValue name="AmountSpecification"> <Characteristic domain="Amount" value="200" code="USD"/> <Characteristic domain="LowerAmount" value="100" code="EUR"/> <Characteristic domain="UpperAmount" value="300" code="EUR"/> </PropertyValue> <PropertyValue name="QuantitySpecification"> <Characteristic domain="Quantity" value="200" code="BOX"/> <Characteristic domain="LowerQuantity" value="100" code="EA"/> <Characteristic domain="UpperQuantity" value="300" code="EA"/> </PropertyValue> </ValueGroup> </PropertyValuation> </Batch>

198PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 199: 355a de soluciones cXML - help.sap.com

</SubcontractingComponent> <SubcontractingComponent quantity="2" requirementDate="2013-08-02T14:37:31-07:00"> <ComponentID>2</ComponentID> <UnitOfMeasure>BOX</UnitOfMeasure> <Description xml:lang="en">Tailpiece</Description> <Product> <SupplierPartID>SupplierPartID2</SupplierPartID> <SupplierPartAuxiliaryID>SupplierPartAuxiliaryID2</SupplierPartAuxiliaryID> <BuyerPartID>BuyerPartID2</BuyerPartID> <IdReference domain="StandardID" identifier="1000"/> <IdReference domain="InternalID" identifier="2000"/> </Product> <ProductRevisionID>12345</ProductRevisionID> <Batch originCountryCode="US" expirationDate="2014-06-10T14:37:31-07:00" productionDate="2013-06-10T14:37:31-07:00"> <BuyerBatchID>BuyerBatchID2</BuyerBatchID> <SupplierBatchID>SupplierBatchID2</SupplierBatchID> <PropertyValuation> <PropertyReference> <IdReference domain="ID" identifier="CHEMICAL"/> </PropertyReference> <ValueGroup> <IdReference domain="ID" identifier="2"/> </ValueGroup> </PropertyValuation> <PropertyValuation> <PropertyReference> <IdReference domain="ID" identifier="DILUTION"/> </PropertyReference> <ValueGroup> <IdReference domain="ID" identifier="dilu"/> <ParentID>2</ParentID> <PropertyValue name="NameSpecification"> <Characteristic domain="Name" value="1+0 - 1+3"/> </PropertyValue> </ValueGroup> </PropertyValuation> <PropertyValuation> <PropertyReference> <IdReference domain="ID" identifier="CAPACITY"/> </PropertyReference> <ValueGroup> <IdReference domain="ID" identifier="cap"/> <ParentID>2</ParentID> <PropertyValue name="NameSpecification"> <Characteristic domain="Name" value="1-4 lt"/> </PropertyValue> </ValueGroup> </PropertyValuation> <PropertyValuation> <PropertyReference> <IdReference domain="ID" identifier="CHEM_FORM"/> </PropertyReference> <ValueGroup> <IdReference domain="ID" identifier="form"/> <ParentID>2</ParentID> <PropertyValue name="NameSpecification"> <Characteristic domain="Name" value="flussig"/> <Characteristic domain="languageCode" value="de"/> </PropertyValue> <PropertyValue name="NameSpecification"> <Characteristic domain="Name" value="liquid"/> <Characteristic domain="languageCode" value="en"/> </PropertyValue> </ValueGroup>

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 199

Page 200: 355a de soluciones cXML - help.sap.com

</PropertyValuation> </Batch> </SubcontractingComponent> <SubcontractingComponent quantity="3" requirementDate="2013-08-03T14:37:31-07:00"> <ComponentID>3</ComponentID> <UnitOfMeasure>BOX</UnitOfMeasure> <Description xml:lang="en">Bridge</Description> <Product> <SupplierPartID>SupplierPartID3</SupplierPartID> <SupplierPartAuxiliaryID>SupplierPartAuxiliaryID3</SupplierPartAuxiliaryID> <BuyerPartID>BuyerPartID3</BuyerPartID> <IdReference domain="StandardID" identifier="1000"/> <IdReference domain="InternalID" identifier="2000"/> </Product> <ProductRevisionID>12345</ProductRevisionID> <Batch originCountryCode="US" expirationDate="2014-06-10T14:37:31-07:00" productionDate="2013-06-10T14:37:31-07:00"> <BuyerBatchID>BuyerBatchID3</BuyerBatchID> <SupplierBatchID>SupplierBatchID3</SupplierBatchID> </Batch> </SubcontractingComponent> </ScheduleLine> <Batch originCountryCode="US" expirationDate="2014-06-10T14:37:31-07:00" productionDate="2013-06-10T14:37:31-07:00"> <BuyerBatchID>BuyerBatchID1-Item1</BuyerBatchID> <SupplierBatchID>SupplierBatchID1-Item1</SupplierBatchID> </Batch> </ItemOut>

Incoterms en pedidos

Los incoterms son una serie de condiciones comerciales definidas previamente publicadas por la Cámara de Comercio Internacional (CCI). Las condiciones comerciales de tres letras de incoterms están relacionadas con prácticas de ventas contractuales comunes. Están pensadas principalmente para comunicar con claridad las tareas, costes y riesgos asociados con el transporte y la entrega de bienes. La edición de Incoterms de 2010 incluye las siguientes 11 reglas:

● EXW (en fábrica)● FCA (libre transportista)● CPT (transporte pagado hasta)● CIP (transporte y seguro pagados hasta)● DAT (entregado en terminal)● DAP (entregado en un punto)● DDP (entregado con derechos pagados)● FAS (libre al costado del buque)● FOB (libre a bordo)● CFR (coste y flete)● CIF (coste, seguro y flete)

Para obtener descripciones detalladas de las reglas de incoterms, consulte el sitio web de la Cámara de Comercio Internacional .

200PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 201: 355a de soluciones cXML - help.sap.com

Para dar soporte a los incoterms en pedidos a nivel de cabecera o a nivel de artículo en línea, se han agregado los siguientes extrínsecos cXML a OrderRequestHeader y ItemDetail:

Nombre extrínseco Este campo almacena...

incoTerm Código de incoterms de tres letras

incoTermDesc Descripción de incoterms

incoTermLocation Ubicación de incoterms

El siguiente extracto de cXML muestra los elementos extrínsecos para los incoterms en OrderRequestHeader:

<OrderRequestHeader orderDate="2016-02-16T01:16:58-08:00" orderID="po-it453245" orderType="regular" type="new"> ... <Extrinsic name = "incoTerm">FOB</Extrinsic> <Extrinsic name = "incoTermDesc">Free on Board</Extrinsic> <Extrinsic name = "incoTermLocation">Lima</Extrinsic> </OrderRequestHeader>

El siguiente extracto de cXML muestra los elementos extrínsecos para los incoterms en ItemDetail:

<ItemDetail> <UnitPrice> <Money currency="USD">20.00</Money> </UnitPrice> <Description xml:lang="en">Computer Video Cables</Description> <UnitOfMeasure>EA</UnitOfMeasure> ... <Extrinsic name = "incoTerm">EXW</Extrinsic> <Extrinsic name = "incoTermDesc">Ex Works</Extrinsic> <Extrinsic name = "incoTermLocation">Santiago</Extrinsic> </ItemDetail>

Extrínseco AribaNetwork.PaymentTermsExplanationUn campo extrínseco cXML admite la explicación de condiciones de pago, que es una descripción de texto libre de las condiciones de pago recibidas del sistema del comprador. Si no se permite que el proveedor cambie las condiciones de pago, la explicación de condiciones de pago se convierte a partir del pedido en factura con fines de información.

El siguiente extrínseco cXML se admite en OrderRequestHeader y InvoiceDetailRequestHeader:

Nombre extrínseco Este campo almacena...

AribaNetwork.PaymentTermsExplanation Texto libre que describe las condiciones de pago con fines de información.

El siguiente extracto de cXML muestra las condiciones de pago en la cabecera de un pedido:

<Request deploymentMode="production"> <OrderRequest> <OrderRequestHeader orderDate="2016-01-29T01:16:58-08:00" orderID="po-pte20150129" orderType="regular" type="new">

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 201

Page 202: 355a de soluciones cXML - help.sap.com

... <PaymentTerm payInNumberOfDays = "14"> <Discount> <DiscountPercent percent = "1.000"></DiscountPercent> </Discount> </PaymentTerm> <PaymentTerm payInNumberOfDays = "30"> </PaymentTerm> <Extrinsic name="AribaNetwork.PaymentTermsExplanation"> After receipt of invoice: 14days 1% disc. 30days net </Extrinsic> </OrderRequestHeader> </OrderRequest> </Request>

NotaEl extrínseco AribaNetwork.PaymentTermsExplanation puede aparecer en OrderRequestHeader o InvoiceDetailRequestHeader sin ningún elemento PaymentTerm que lo acompañe.

Órdenes de entrega basadas en plan de entregaEl DTD 1.2.026 cXML ha introducido cambios que admiten versiones del plan de entrega.

Para obtener más información sobre cXML, consulte la Guía de referencia de cXML y DTD disponible en http://www.cxml.org .

ReleaseInfo [página 202]

ScheduleLineReleaseInfo [página 203]

agreementType [página 204]

ShipNoticePortion [página 205]

ReleaseInfo

ReleaseInfo se ha agregado a ItemOut como un elemento opcional. ReleaseInfo almacena los detalles sobre la versión de los artículos o materiales.

ReleaseInfo puede contener los elementos siguientes:

Elemento Descripción

ShipNoticeReleaseInfo Hace referencia al aviso de expedición anterior creado a partir de un plan de entrega. Esta referencia es contra la expedición anterior realizada para el reparto en la versión del plan de en­trega.

UnitofMeasure Unidad de medida para la cantidad especificada para el artí­culo de reparto.

202PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 203: 355a de soluciones cXML - help.sap.com

Elemento Descripción

Extrinsic Cualquier información adicional para el artículo de reparto.

ReleaseInfo debe contener los atributos siguientes:

Atributo Descripción

releaseType Un campo obligatorio. Un valor de cadena para identificar el tipo de plan de entrega contra la versión del plan de entrega.

Valores posibles:

● JIT (Justo a tiempo)● previsión

cumulativeReceivedQuantity Un campo obligatorio. Un valor numérico para identificar la cantidad acumulada de todos los bienes recibidos contra la or­den de entrega basada en plan de entrega por un período hasta una fecha en concreto.

productionGoAheadEndDate Un campo opcional. Fecha que denota el fin del período de li­beración de la producción (liberación para producción).

materialGoAheadEndDate Fecha que denota el fin del período de liberación de material (liberación para compra de material a utilizar).

Ejemplo

<ReleaseInfo releaseType="forecast" cumulativeReceivedQuantity="0" productionGoAheadEndDate="2014-06-13T14:37:31-07:00" materialGoAheadEndDate="2014-11-14T14:37:31-07:00" <UnitOfMeasure>EA</UnitOfMeasure> </ReleaseInfo>

ScheduleLineReleaseInfo

Un elemento, ScheduleLineReleaseInfo, se ha agregado al elemento ScheduleLine. ScheduleLineReleaseInfo almacena detalles sobre una liberación específica de artículos o materiales para un reparto.

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 203

Page 204: 355a de soluciones cXML - help.sap.com

ScheduleLineReleaseInfo contiene los atributos siguientes:

Atributo Descripción

commitmentCode Un valor de cadena para identificar el tipo de entrega. El valor puede ser uno de los siguientes:

firm g: Liberación para producción. El suministrador puede expedir contra el reparto. El cliente es el responsable del coste de la producción y del coste de la compra de material.

tradeoff: Liberación para compra de material. El suminis­trador puede expedir contra el reparto si la regla está habili­tada. El comprador es el responsable del coste y de la compra de material.

forecast: A modo informativo. El cliente puede modificar el reparto sin que se generen deudas con el suministrador.

cumulativeScheduledQuantity La cantidad total a expedir para un artículo en línea en con­creto mediante el reparto.

Ejemplo

<ScheduleLine quantity="100" requestedDeliveryDate="2014-05-10T14:37:31-07:00"> <UnitOfMeasure>EA</UnitOfMeasure> <ScheduleLineReleaseInfo commitmentCode="firm" cumulativeScheduledQuantity="100"> <UnitOfMeasure>EA</UnitOfMeasure> </ScheduleLineReleaseInfo> </ScheduleLine>

agreementType

Un atributo, agreementType, se ha agregado al elemento MasterAgreementIDInfo y al elemento MasterAgreementReference para indicar si el acuerdo referenciado es una orden de entrega basada en plan de entrega.

Ejemplo

<MasterAgreementIDInfo agreementID="SA301" agreementType="scheduling_agreement"/>

204PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 205: 355a de soluciones cXML - help.sap.com

ShipNoticePortion

ShipNoticePortion debe incluir dos elementos adicionales opcionales, MasterAgreementReference y MasterAgreementID para identificar el acuerdo maestro del que deriva el aviso de expedición.

En la tabla siguiente se describen estos elementos.

Elemento Descripción

MasterAgreementReference Opcional. Hace referencia al acuerdo maestro del que deriva la versión.

MasterAgreementIDInfo Opcional. Indica el ID del acuerdo maestro del que deriva la versión.

Artículos en línea de servicio planificada y sin planificarAriba Network admite los artículos en línea de servicio planificada y sin planificar en los pedidos de compra.

Artículos en línea de servicio planificados [página 205]

Artículos en línea de servicio sin planificar [página 208]

Líneas de servicio planificadas frente a líneas de servicio sin planificar [página 210]

Extrínsecos para enlaces en los que se puede hacer clic [página 211]

Extrínsecos para períodos de servicio [página 211]

Extrínseco para pedidos de compra heredados [página 212]

Cambios introducidos por Ariba Buyer 7.0.6 [página 213]

Números de línea externa [página 213]

Pedido de servicio con jerarquía multinivel [página 213]

Artículos en línea de servicio planificados

Los artículos en línea de servicio planificados describen servicios o bienes materiales específicos mediante <ItemDetail>.

● Si los artículos en línea de servicio planificados son artículos en línea individuales, requieren una hoja de entrada de servicios.

● Si los artículos en línea de servicio planificados son grupos de artículos primarios con artículos agrupados en ellos, el grupo de artículos primario requiere una hoja de entrada de servicios.

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 205

Page 206: 355a de soluciones cXML - help.sap.com

Ejemplo de cXML de SAP ERP

<ItemOut itemType = "composite" lineNumber = "10" quantity = "1.0" requestedDeliveryDate = "2016-01-12T12:00:00+01:00" requiresServiceEntry = "yes"> <ItemID> <SupplierPartID></SupplierPartID> </ItemID> <BlanketItemDetail> <Description xml:lang = "en">Cleaning Services</Description> <MaxAmount> <Money currency = "EUR">474.0</Money> </MaxAmount> <MaxQuantity>1.0</MaxQuantity> <MinQuantity>1.0</MinQuantity> <UnitPrice> <Money currency = "EUR">474.0</Money> </UnitPrice> <UnitOfMeasure>C62</UnitOfMeasure> <PriceBasisQuantity conversionFactor = "1" quantity = "1.0"> <UnitOfMeasure>C62</UnitOfMeasure> </PriceBasisQuantity> <Classification domain = "not available">Material group 1</Classification> </BlanketItemDetail> <SpendDetail> <Extrinsic name = "ConsiderServiceAsMaterialType"></Extrinsic> </SpendDetail> <Tolerances> <PriceTolerance> <Percentage percent = "20.00"></Percentage> </PriceTolerance> </Tolerances> <ScheduleLine lineNumber = "1" quantity = "1.0" requestedDeliveryDate = "2016-01-12T12:00:00+01:00"> <UnitOfMeasure>C62</UnitOfMeasure> </ScheduleLine></ItemOut><ItemOut lineNumber = "1000100010" parentLineNumber = "10" quantity = "34.0"> <ItemID> <SupplierPartID>SUPPLIER_NO</SupplierPartID> <BuyerPartID>1000020</BuyerPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency = "EUR">11.0</Money> </UnitPrice> <Description xml:lang = "en">Cleaning Windows</Description> <UnitOfMeasure>HUR</UnitOfMeasure> <Classification domain = "not available">Material group 1 </Classification> </ItemDetail> <SpendDetail> <Extrinsic name = "ConsiderServiceAsMaterialType"></Extrinsic> </SpendDetail> </ItemOut>

Ejemplo de cXML de Add-On de SAP Business Suite para la integración de Ariba Network

<ItemOut quantity="1.0" lineNumber="10"

206PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 207: 355a de soluciones cXML - help.sap.com

requestedDeliveryDate="2016-07-13T12:00:00+02:00" itemType="composite" requiresServiceEntry="yes"> <ItemID> <SupplierPartID/> </ItemID> <BlanketItemDetail> <Description xml:lang="en">Cleaning Services</Description> <MaxAmount> <Money currency="EUR">984.0</Money> </MaxAmount> <MaxQuantity>1.0</MaxQuantity> <MinQuantity>1.0</MinQuantity> <UnitPrice> <Money currency="EUR">984.0</Money> </UnitPrice> <UnitOfMeasure>C62</UnitOfMeasure> <PriceBasisQuantity quantity="1.0" conversionFactor="1"> <UnitOfMeasure>C62</UnitOfMeasure> </PriceBasisQuantity> <Classification domain="not available">Material group 2</Classification> </BlanketItemDetail> <SpendDetail> <Extrinsic name="GenericServiceCategory"/> </SpendDetail> <ScheduleLine quantity="1.0" requestedDeliveryDate="2016-07-13T12:00:00+02:00" lineNumber="1"> <UnitOfMeasure>C62</UnitOfMeasure> </ScheduleLine></ItemOut><ItemOut quantity="123.0" lineNumber="1000100010" parentLineNumber="10"> <ItemID> <SupplierPartID/> <BuyerPartID>1000020</BuyerPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="EUR">8.0</Money> </UnitPrice> <Description xml:lang="en">cleaning windows</Description> <UnitOfMeasure>HUR</UnitOfMeasure> <Classification domain="not available">Material group 2</Classification> </ItemDetail> <SpendDetail> <Extrinsic name="GenericServiceCategory">Standard Service</Extrinsic> </SpendDetail></ItemOut><ItemOut quantity="1.0" lineNumber="20" requestedDeliveryDate="2016-07-13T12:00:00+02:00" itemType="composite" requiresServiceEntry="yes"> <ItemID> <SupplierPartID/> </ItemID> <BlanketItemDetail> <Description xml:lang="en">Maintenance</Description> <MaxAmount> <Money currency="EUR">800.0</Money> </MaxAmount> <MaxQuantity>1.0</MaxQuantity> <MinQuantity>1.0</MinQuantity> <UnitPrice> <Money currency="EUR">800.0</Money> </UnitPrice>

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 207

Page 208: 355a de soluciones cXML - help.sap.com

<UnitOfMeasure>C62</UnitOfMeasure> <PriceBasisQuantity quantity="1.0" conversionFactor="1"> <UnitOfMeasure>C62</UnitOfMeasure> </PriceBasisQuantity> <Classification domain="not available">Material group 2</Classification> </BlanketItemDetail> <SpendDetail> <Extrinsic name="GenericServiceCategory"/> </SpendDetail> <ScheduleLine quantity="1.0" requestedDeliveryDate="2016-07-13T12:00:00+02:00" lineNumber="1"> <UnitOfMeasure>C62</UnitOfMeasure> </ScheduleLine></ItemOut><ItemOut quantity="1.0" lineNumber="1000200010" parentLineNumber="20"> <ItemID> <SupplierPartID/> <BuyerPartID>1000030</BuyerPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="EUR">800.0</Money> </UnitPrice> <Description xml:lang="en">yearly maintenance central heating</Description> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="not available">Material group 2</Classification> </ItemDetail> <SpendDetail> <Extrinsic name="GenericServiceCategory">Maintenance</Extrinsic> </SpendDetail> </ItemOut>

Artículos en línea de servicio sin planificar

Los artículos en línea de servicio sin planificar describen servicios generales con <BlanketItemDetail> y un necesario<MaxAmount>.

Los artículos en línea de servicio sin planificar tienen las características siguientes:

● Si son líneas individuales, requieren una hoja de entrada de servicios.● Si son grupos de artículos principales, no contienen ningún artículo agrupado por debajo de ellos.

Ejemplo

<ItemOut lineNumber="1" quantity="1" requestedDeliveryDate="2013-09-1" requiresServiceEntry="yes"> <ItemID> <SupplierPartID>LW4001</SupplierPartID> <SupplierPartAuxiliaryID></SupplierPartAuxiliaryID>

208PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 209: 355a de soluciones cXML - help.sap.com

</ItemID> <BlanketItemDetail> <Description xml:lang="en">Site preparation of parcel no. 110 (3 acres)</Description> <MaxAmount> <Money currency="USD">70000</Money> </MaxAmount> <UnitPrice><Money currency="USD">50000</Money></UnitPrice> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="ascc">606501</Classification> <Extrinsic name="Construction"></Extrinsic> <Extrinsic name="ServicePeriod"> <Period endDate="2013-09-01T23:59:59-00:00" startDate="2012-07-12T00:00:00-00:00"> </Period> </Extrinsic> </BlanketItemDetail> <Distribution> <Accounting name="Distribution Charge"> <AccountingSegment id="100"> <Name xml:lang="en">Construction</Name> <Description xml:lang="en">Western Division</Description> </AccountingSegment> </Accounting> <Charge><Money currency="USD">50000</Money></Charge> </Distribution> </ItemOut>

Extrínsecos ExpectedUnplanned y MaximumUnplanned

Puede pasar los valores Valor esperado y Límite global para los artículos en línea sin planificar mediante extrínsecos.

Valor esperado se muestra tanto a compradores como a proveedores en los pedidos de compra a nivel de artículo en línea. Límite global no se muestra a los usuarios proveedores. Los proveedores no pueden enviar hojas de entrada de servicios que incluyan artículos en línea sin planificar con un valor que supere el Límite global.

NotaLímite global debe ser superior o igual a Valor esperado.

Los siguientes elementos extrínsecos admiten Valor esperado y Límite global:

Elemento Contenido en Descripción

<Extrinsic name="ExpectedUnplanned">

<BlanketItemDetail> Valor esperado para artículos en línea sin pla­nificar. Mostrado al comprador y al proveedor en el pedido de compra.

<Extrinsic name="MaximumUnplanned">

<BlanketItemDetail> Límite global (valor máximo) para artículos en línea sin planificar. No revelado a los proveedo­res.

Los pedidos de servicio cXML y las hojas de entrada de servicios descargadas desde la interfaz de usuario de Ariba Network por los proveedores, no contienen elementos extrínsecos MaximumUnplanned.

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 209

Page 210: 355a de soluciones cXML - help.sap.com

cXML de ejemplo con valor esperado y límite global

<ItemOut lineNumber="1" quantity="1" requestedDeliveryDate="2015-12-17" requiresServiceEntry="yes"> <ItemID> <SupplierPartID>LW4001</SupplierPartID> <SupplierPartAuxiliaryID/> </ItemID> <BlanketItemDetail> <Description xml:lang="en">Site preparation of parcel no. 100 (3 acres)</Description> <UnitPrice> <Money currency="USD">50000</Money> </UnitPrice> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="ascc">606501</Classification> <Extrinsic name="ServicePeriod"> <Period endDate="2015-12-17T17:00:00+08:00" startDate="2015-09-23T08:00:00+08:00"/> </Extrinsic> <Extrinsic name="ExpectedUnplanned"> <Money currency="USD">50000</Money> </Extrinsic> <Extrinsic name="MaximumUnplanned"> <Money currency="USD">70000</Money> </Extrinsic> </BlanketItemDetail> </ItemOut>

Líneas de servicio planificadas frente a líneas de servicio sin planificar

Cuando crea aplicaciones de pedido de compra es posible que necesite diferenciar entre líneas de servicio planificadas y sin planificar.

La siguiente tabla resume las características de líneas de servicio planificadas frente a líneas de servicio sin planificar:

Línea de servicio Características Ejemplos

Planificada La línea de servicio es un grupo de artículos con artículos agrupados. Si el precio por unidad está visible, los subtotales del artículo agrupado se suman al precio por unidad.

Si el comprador permite a los proveedores agregar a un pedido artículos por encargo y la lí­nea de servicio especifica un importe máximo (oculto) que es mayor que el precio por unidad, el proveedor puede agregar artículos no planifi­cados o por encargo a una línea de servicio pla­nificada hasta los límites de tolerancia.

Línea planificada:

● 1 Línea de servicio A $300 (importe máximo $300)○ 1.1 Línea de servicio A1 $200○ 1.2 Artículo de bienes A2 $100

Línea planificada a la cual el proveedor puede agregar artículos no planificados o por encargo:

● 2 Línea de servicio B $300 (importe máximo $500)○ 2,1 Línea de servicio B1 $200○ 2,2 Artículo de bienes B2 $100

210PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 211: 355a de soluciones cXML - help.sap.com

Línea de servicio Características Ejemplos

Sin planificar La línea de servicio es un grupo de artículos que no tiene artículos agrupados. El precio por uni­dad puede estar visible u oculto.

El proveedor debe agregar artículos a la línea de servicio sin planificar. El subtotal de estos artí­culos puede alcanzar el precio por unidad si este es visible y no debe exceder el importe má­ximo (oculto).

Línea no planificada con precio por unidad:

● 1 Línea de servicio A $300 (importe máximo $300)Línea no planificada con importe oculto:

● 2 Línea de servicio B no revelado (importe má­ximo $500)

Extrínsecos para enlaces en los que se puede hacer clic

Ariba Network puede representar URL como enlaces a los que se puede hacer clic en facturas y pedidos de compra en línea.

Estos enlaces URL se producen mediante elementos Extrinsic en forma:

<Extrinsic name="anyname"> <URL name="click me">http://www.bigcompany.com/info</URL> </Extrinsic>

Este ejemplo produce el siguiente texto en línea:

anyname:click me

Las palabras "hacer clic" están subrayadas y puede hacer clic en ellas, y el enlace de destino es http://www.bigcompany.com/info</URL.

Si el elemento URL no tiene el atributo name, Ariba Network muestra la URL y la convierte en un enlace al que se puede hacer clic.

Extrínsecos para períodos de servicio

Puede especificar períodos de servicio para líneas de servicio en un pedido de compra utilizando el extrínseco ServicePeriod en el extrínseco GenericServiceCategory bien en ItemDetail o en BlanketItemDetail. Como alternativa, puede especificar el ServicePeriod en el elemento SpendDetail de ItemOut. Ambos son cXML válidos. No importa el método que utilice, asegúrese de que el adaptador Ariba Network de su sistema back end asigne los datos correctamente.

NotaAdd-on de SAP Business Suite para la integración de Ariba Network utiliza ScheduleLine@requestedDeliveryDate para especificar la fecha de entrega solicitada para artículos en línea.

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 211

Page 212: 355a de soluciones cXML - help.sap.com

Ejemplo de ServicePeriod en GenericServiceCategory

<Extrinsic name="GenericServiceCategory"> <Extrinsic name="ServicePeriod"> <Period endDate="2013-09-01T23:59:59-00:00" startDate="2012-07-12T00:00:00-00:00"></Period> </Extrinsic> </Extrinsic>

Ejemplo de ServicePeriod en SpendDetail

<SpendDetail> <Extrinsic name="ServicePeriod"> <Period endDate="2013-09-01T23:59:59-00:00" startDate="2012-07-12T00:00:00-00:00"></Period> </Extrinsic> </SpendDetail>

Información relacionada

Elemento ScheduleLine [página 180]

Extrínseco para pedidos de compra heredados

Puede cargar pedidos de compra cumplidos anteriormente para que los proveedores puedan facturarle a través de Ariba Network. Ariba Network orienta estos pedidos de compra heredados a la bandeja de entrada en línea de su proveedor, aunque se utilice otro método de orientación. El pedido de compra heredado contiene el comentario "Este pedido de compra ya se ha cumplido".

Para diferenciar los pedidos de compra heredados de los pedidos de compra nuevos, incluya un elemento extrínseco denominado AribaNetwork.LegacyOrders en la cabecera de la solicitud de pedidos.

Ejemplo

<OrderRequestHeader orderDate="2015-10-31T13:04:04-08:00" orderID="PCO66"> ... <Extrinsic name="AribaNetwork.LegacyOrders"></Extrinsic> ... </OrderRequestHeader>

Ariba Network muestra un mensaje de advertencia que le informa de que el pedido ya se ha cumplido en la página de pedidos de compra en línea y establece el estado del pedido en "Enviado/Nuevo".

212PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 213: 355a de soluciones cXML - help.sap.com

Cambios introducidos por Ariba Buyer 7.0.6Ariba Buyer 7.0.6 corrigió dos problemas en los documentos OrderRequest.

● Las versiones anteriores de Ariba Buyer presentaban problemas menores en pedidos de cambio cXML: Los valores lineNumber para los artículos eran diferentes en los pedidos de cambio y en los pedidos originales. Ariba Buyer 7.0.6 y posteriores conserva los números de los artículos en línea originales en los pedidos de cambio, lo cual se ajusta a la especificación cXML.

● Las versiones anteriores de Ariba Buyer utilizaban requestedDeliveryDate con un valor temporal innecesario, por ejemplo:

requestedDeliveryDate="2005-02-01T00:00:00+09:00"

Ariba Buyer 7.0.6 y posteriores sólo incluyen para este atributo el valor de fecha, por ejemplo:

requestedDeliveryDate="2005-02-01"

Números de línea externaPara admitir números de línea externa de artículos en pedidos de compra, se ha agregado el siguiente extrínseco cXML a BlanketItemDetail y ItemDetail:

Nombre extrínseco Este campo almacena...

extLineNumber Un número. Puede tener ceros a la izquierda (por ejemplo, "001"). Si Ariba Network muestra el número de línea externa de un artículo, concatena todos los números de línea externa de un artículo y todos los artículos principales.

El extracto cXML siguiente muestra el nuevo elemento extrínseco para artículos en línea externos de pedido de compra:

<BlanketItemDetail> <Description xml:lang="en">ADB2226 - Build a house</Description> <UnitPrice> <Money currency="USD">50000.00</Money> </UnitPrice> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="UNSPSC">721315</Classification> ... <Extrinsic name="extLineNumber"/>001</Extrinsic> </BlanketItemDetail>

Pedido de servicio con jerarquía multinivelUn pedido de servicio con una jerarquía multinivel tiene las características siguientes:

● Los artículos de esquema de nivel superior tienen los elementos MaxAmount, UnitPrice, UnitOfMeasure y PriceBasisQuantity. Los artículos de esquema que no se encuentran en el nivel superior NO tienen estos elementos.

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 213

Page 214: 355a de soluciones cXML - help.sap.com

● El elemento ItemOut puede contener un atributo requiresServiceEntry=“yes”, que especifica que el proveedor debe crear una hoja de entrada de servicios para el artículo en línea.

● El atributo parentLineNumber es un campo obligatorio para todos los artículos con artículos principales. Hace referencia a los números de línea del artículo en línea principal.

● El atributo ItemType puede contener dos valores: “composite” para identificar un artículo de esquema o “item” para identificar un artículo en línea independiente. Los elementos ItemOut con ItemType pueden necesitar una hoja de entrada de servicios.

● Los artículos tienen números de línea externa especificados por el elemento extrínseco extLineNumber.

Ejemplo

<OrderRequest> <OrderRequestHeader orderID = "4500018482" orderType = "regular" orderDate = "2015-03-31T02:30:01+05:30" type = "new"> <Total> <Money currency = "USD">239700.00</Money> </Total> <ShipTo> <Address isoCountryCode = "US" addressID = "3000"> <Name xml:lang = "EN">New York</Name> <PostalAddress> <Street>691 Broadway</Street> <City>NEW YORK</City> <Municipality>NEW YORK</Municipality> <State>NY</State> <PostalCode>10001</PostalCode> <Country isoCountryCode = "US"></Country> </PostalAddress> <Phone> <TelephoneNumber> <CountryCode isoCountryCode = "US"></CountryCode> <AreaOrCityCode></AreaOrCityCode> <Number>001-9287-34571</Number> </TelephoneNumber> </Phone> <Fax> <TelephoneNumber> <CountryCode isoCountryCode = "US"></CountryCode> <AreaOrCityCode></AreaOrCityCode> <Number>001-9287-34573</Number> </TelephoneNumber> </Fax> </Address> </ShipTo> <BillTo> <Address isoCountryCode = "US" addressID = "3000"> <Name xml:lang = "EN">IDES US INC</Name> <PostalAddress> <Street>1230 Lincoln Avenue</Street> <City>NEW YORK</City> <Municipality>NEW YORK</Municipality> <State>NY</State> <PostalCode>10019</PostalCode> <Country isoCountryCode = "US"></Country> </PostalAddress> <Phone> <TelephoneNumber> <CountryCode isoCountryCode = "US"></CountryCode> <AreaOrCityCode></AreaOrCityCode> <Number>212-555-0983</Number>

214PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 215: 355a de soluciones cXML - help.sap.com

</TelephoneNumber> </Phone> <Fax> <TelephoneNumber> <CountryCode isoCountryCode = "US"></CountryCode> <AreaOrCityCode></AreaOrCityCode> <Number>212-555-5693</Number> </TelephoneNumber> </Fax> </Address> </BillTo> <PaymentTerm payInNumberOfDays = "14"> <Discount> <DiscountPercent percent = "3.000"></DiscountPercent> </Discount> </PaymentTerm> <PaymentTerm payInNumberOfDays = "30"> <Discount> <DiscountPercent percent = "2.000"></DiscountPercent> </Discount> </PaymentTerm> <PaymentTerm payInNumberOfDays = "45"></PaymentTerm> <Contact role = "supplierCorporate" addressID = "0000001000"> <Name xml:lang = "EN">C.E.B. BERLIN</Name> <PostalAddress> <Street>Kolping Str. 15</Street> <City>Berlin</City> <Municipality></Municipality> <State>11</State> <PostalCode>12001</PostalCode> <Country isoCountryCode = "DE"></Country> </PostalAddress> <Email></Email> <Phone> <TelephoneNumber> <CountryCode isoCountryCode = "DE"></CountryCode> <AreaOrCityCode></AreaOrCityCode> <Number>06894/55501-0</Number> </TelephoneNumber> </Phone> <Fax> <TelephoneNumber> <CountryCode isoCountryCode = "DE"></CountryCode> <AreaOrCityCode></AreaOrCityCode> <Number>06894/55501-100</Number> </TelephoneNumber> </Fax> </Contact> <Extrinsic name = "CompanyCode">3000</Extrinsic> <Extrinsic name = "Ariba.invoicingAllowed">Yes</Extrinsic> <Extrinsic name = "Ariba.availableAmount">239700</Extrinsic> <Extrinsic name = "partyAdditionalID">0000001000</Extrinsic> </OrderRequestHeader> <ItemOut itemType = "composite" requestedDeliveryDate = "2015-04-27T00:00:00+05:30" lineNumber = "00010" quantity = "1.000" requiresServiceEntry = "yes"> <ItemID> <SupplierPartID></SupplierPartID> <BuyerPartID></BuyerPartID> </ItemID> <BlanketItemDetail> <Description xml:lang = "en">SAP Consulting</Description> <MaxAmount> <Money currency = "USD">239700</Money> </MaxAmount> <UnitPrice> <Money currency = "USD">239700</Money> </UnitPrice>

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 215

Page 216: 355a de soluciones cXML - help.sap.com

<UnitOfMeasure>SU</UnitOfMeasure> <PriceBasisQuantity conversionFactor = "1" quantity = "1"> <UnitOfMeasure>SU</UnitOfMeasure> </PriceBasisQuantity> <Classification domain = "NotAvailable">00801</Classification> <Extrinsic name = "AccountCategory">K</Extrinsic> <Extrinsic name = "ReceivingType"></Extrinsic> <Extrinsic name = "extLineNumber">00010</Extrinsic> </BlanketItemDetail> <ScheduleLine requestedDeliveryDate = "2015-04-27T00:00:00+05:30" quantity = "1.000"> <UnitOfMeasure>SU</UnitOfMeasure> </ScheduleLine> </ItemOut> <ItemOut parentLineNumber = "00010" itemType = "composite" lineNumber = "0000200010" quantity = "1.0" requiresServiceEntry = "yes"> <ItemID> <SupplierPartID></SupplierPartID> </ItemID> <BlanketItemDetail> <Description xml:lang = "EN">Functional_Architect</Description> <Extrinsic name = "AccountCategory">K</Extrinsic> <Extrinsic name = "extLineNumber">FUN_ARCH</Extrinsic> </BlanketItemDetail> <SpendDetail> <Extrinsic name = "service">service</Extrinsic> </SpendDetail> </ItemOut> <ItemOut parentLineNumber = "0000200010" itemType = "composite" lineNumber = "0000300010" quantity = "1.0" requiresServiceEntry = "yes"> <ItemID> <SupplierPartID></SupplierPartID> </ItemID> <BlanketItemDetail> <Description xml:lang = "EN">Technical Consultants</Description> <Extrinsic name = "AccountCategory">K</Extrinsic> <Extrinsic name = "extLineNumber">CONSULTS</Extrinsic> </BlanketItemDetail> <SpendDetail> <Extrinsic name = "service">service</Extrinsic> </SpendDetail> </ItemOut> <ItemOut parentLineNumber = "00010" lineNumber = "1000100010" quantity = "45.000"> <ItemID> <SupplierPartID></SupplierPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency = "USD">1500</Money> </UnitPrice> <Description xml:lang = "EN">Architects</Description> <UnitOfMeasure>DAY</UnitOfMeasure> <PriceBasisQuantity conversionFactor = "1" quantity = "1"> <UnitOfMeasure>DAY</UnitOfMeasure> </PriceBasisQuantity> <Classification domain = "UNSPSC">00801</Classification> <Extrinsic name = "AccountCategory">K</Extrinsic> <Extrinsic name = "extLineNumber">10</Extrinsic> </ItemDetail> <SpendDetail> <Extrinsic name = "service">service</Extrinsic> </SpendDetail> <Distribution> <Accounting name = "DistributionCharge"> <AccountingSegment id = "0000400000"> <Name xml:lang = "en">GeneralLedger</Name> <Description xml:lang = "en"></Description>

216PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 217: 355a de soluciones cXML - help.sap.com

</AccountingSegment> <AccountingSegment id = "0000002100"> <Name xml:lang = "en">CostCenter</Name> <Description xml:lang = "en"></Description> </AccountingSegment> <AccountingSegment id = "100.00"> <Name xml:lang = "en">Percentage</Name> <Description xml:lang = "en"></Description> </AccountingSegment> </Accounting> <Charge> <Money currency = "USD">67500.00</Money> </Charge> </Distribution> </ItemOut> <ItemOut parentLineNumber = "0000200010" lineNumber = "1000200010" quantity = "90.000"> <ItemID> <SupplierPartID></SupplierPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency = "USD">900</Money> </UnitPrice> <Description xml:lang = "EN">Functional Consultants</Description> <UnitOfMeasure>DAY</UnitOfMeasure> <PriceBasisQuantity conversionFactor = "1" quantity = "1"> <UnitOfMeasure>DAY</UnitOfMeasure> </PriceBasisQuantity> <Classification domain = "UNSPSC">00801</Classification> <Extrinsic name = "AccountCategory">K</Extrinsic> <Extrinsic name = "extLineNumber">10</Extrinsic> </ItemDetail> <SpendDetail> <Extrinsic name = "service">service</Extrinsic> </SpendDetail> <Distribution> <Accounting name = "DistributionCharge"> <AccountingSegment id = "0000400000"> <Name xml:lang = "en">GeneralLedger</Name> <Description xml:lang = "en"></Description> </AccountingSegment> <AccountingSegment id = "0000001200"> <Name xml:lang = "en">CostCenter</Name> <Description xml:lang = "en"></Description> </AccountingSegment> <AccountingSegment id = "100.00"> <Name xml:lang = "en">Percentage</Name> <Description xml:lang = "en"></Description> </AccountingSegment> </Accounting> <Charge> <Money currency = "USD">81000.00</Money> </Charge> </Distribution> </ItemOut> <ItemOut parentLineNumber = "0000200010" lineNumber = "1000200020" quantity = "110.000"> <ItemID> <SupplierPartID></SupplierPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency = "USD">750</Money> </UnitPrice> <Description xml:lang = "EN">Technical Architect</Description> <UnitOfMeasure>DAY</UnitOfMeasure> <PriceBasisQuantity conversionFactor = "1" quantity = "1">

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 217

Page 218: 355a de soluciones cXML - help.sap.com

<UnitOfMeasure>DAY</UnitOfMeasure> </PriceBasisQuantity> <Classification domain = "UNSPSC">00801</Classification> <Extrinsic name = "AccountCategory">K</Extrinsic> <Extrinsic name = "extLineNumber">20</Extrinsic> </ItemDetail> <SpendDetail> <Extrinsic name = "service">service</Extrinsic> </SpendDetail> <Distribution> <Accounting name = "DistributionCharge"> <AccountingSegment id = "0000400000"> <Name xml:lang = "en">GeneralLedger</Name> <Description xml:lang = "en"></Description> </AccountingSegment> <AccountingSegment id = "0000002100"> <Name xml:lang = "en">CostCenter</Name> <Description xml:lang = "en"></Description> </AccountingSegment> <AccountingSegment id = "100.00"> <Name xml:lang = "en">Percentage</Name> <Description xml:lang = "en"></Description> </AccountingSegment> </Accounting> <Charge> <Money currency = "USD">82500.00</Money> </Charge> </Distribution> </ItemOut> <ItemOut parentLineNumber = "0000300010" lineNumber = "1000300010" quantity = "7.000"> <ItemID> <SupplierPartID></SupplierPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency = "USD">600</Money> </UnitPrice> <Description xml:lang = "EN">Sr.Consultants</Description> <UnitOfMeasure>DAY</UnitOfMeasure> <PriceBasisQuantity conversionFactor = "1" quantity = "1"> <UnitOfMeasure>DAY</UnitOfMeasure> </PriceBasisQuantity> <Classification domain = "UNSPSC">00801</Classification> <Extrinsic name = "AccountCategory">K</Extrinsic> <Extrinsic name = "extLineNumber">10</Extrinsic> </ItemDetail> <SpendDetail> <Extrinsic name = "service">service</Extrinsic> </SpendDetail> <Distribution> <Accounting name = "DistributionCharge"> <AccountingSegment id = "0000400000"> <Name xml:lang = "en">GeneralLedger</Name> <Description xml:lang = "en"></Description> </AccountingSegment> <AccountingSegment id = "0000002100"> <Name xml:lang = "en">CostCenter</Name> <Description xml:lang = "en"></Description> </AccountingSegment> <AccountingSegment id = "100.00"> <Name xml:lang = "en">Percentage</Name> <Description xml:lang = "en"></Description> </AccountingSegment> </Accounting> <Charge> <Money currency = "USD">4200.00</Money> </Charge>

218PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 219: 355a de soluciones cXML - help.sap.com

</Distribution> </ItemOut> <ItemOut parentLineNumber = "0000300010" lineNumber = "1000300020" quantity = "10.000"> <ItemID> <SupplierPartID></SupplierPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency = "USD">450</Money> </UnitPrice> <Description xml:lang = "EN">Jr.Consultants</Description> <UnitOfMeasure>DAY</UnitOfMeasure> <PriceBasisQuantity conversionFactor = "1" quantity = "1"> <UnitOfMeasure>DAY</UnitOfMeasure> </PriceBasisQuantity> <Classification domain = "UNSPSC">00801</Classification> <Extrinsic name = "AccountCategory">K</Extrinsic> <Extrinsic name = "extLineNumber">20</Extrinsic> </ItemDetail> <SpendDetail> <Extrinsic name = "service">service</Extrinsic> </SpendDetail> <Distribution> <Accounting name = "DistributionCharge"> <AccountingSegment id = "0000400000"> <Name xml:lang = "en">GeneralLedger</Name> <Description xml:lang = "en"></Description> </AccountingSegment> <AccountingSegment id = "0000001200"> <Name xml:lang = "en">CostCenter</Name> <Description xml:lang = "en"></Description> </AccountingSegment> <AccountingSegment id = "100.00"> <Name xml:lang = "en">Percentage</Name> <Description xml:lang = "en"></Description> </AccountingSegment> </Accounting> <Charge> <Money currency = "USD">4500.00</Money> </Charge> </Distribution> </ItemOut> </OrderRequest>

Documentos de respuestaDespués de que Ariba Network reenvíe una OrderRequest a un proveedor, el proveedor debe responder con una Response cXML en la misma conexión HTTP en un período de cinco minutos. La respuesta sirve de confirmación.

La Response no es ningún acuerdo para expedir artículos, simplemente es una confirmación de que la OrderRequest se ha recibido, se ha autentificado correctamente y que se valida correctamente contra el DTD. Para comunicar un estado de pedido detallado, el proveedor puede enviar documentos ConfirmationRequest a continuación.

Ejemplo de documento de respuesta [página 220]

Confirmaciones de pedido de compra [página 220]

Otras formas de confirmar pedidos de compra [página 221]

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 219

Page 220: 355a de soluciones cXML - help.sap.com

Confirmaciones de pedido de compra global [página 221]

Documentos duplicados [página 222]

Envío de mensajes de emisión a proveedores [página 222]

Ejemplo de documento de respuesta

Una simple respuesta a una solicitud de pedido es una confirmación HTTP de que se ha recibido el pedido.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd"><cXML payloadID="994994" xml:lang="en" timestamp="2002-03-12T18:39:09-08:00"> <Response> <Status code="200" text="OK"/> </Response> </cXML>

No se hace referencia al documento OrderRequest porque la Response se envía simultáneamente en la misma conexión HTTP utilizada para transmitir el documento OrderRequest.

Si Ariba Network no recibe una Response en el plazo de cinco minutos, reenvía la OrderRequest con el mismo payloadID. Después de 10 intentos (uno por hora), Ariba Network mantiene la transacción y la etiqueta como "Fallido".

No hay ningún elemento denominado “OrderResponse” porque los únicos datos que deben devolverse a Ariba Network es la parte Status de la respuesta.

Confirmaciones de pedido de compra

Los proveedores deben confirmar que han recibido pedidos de compra cXML y EDI de Ariba Network y que son sintácticamente correctos. Las confirmaciones hacen que el estado de enrutamiento del pedido de compra pase de "enviado" a "confirmado" o "fallido".

Ariba Buyer 8.1 (o posteriores) utiliza la transacción para obtener documentos pendientes cXML para recuperar documentos StatusUpdateRequest que contienen confirmaciones de recepción de pedidos de compra de Ariba Network. Los usuarios de versiones anteriores de Ariba Buyer deben iniciar sesión en Ariba Network para ver las confirmaciones de los pedidos de compra.

220PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 221: 355a de soluciones cXML - help.sap.com

Los requisitos de la confirmación del pedido de compra de Ariba Network dependen de los métodos de enrutamiento de los proveedores. La siguiente tabla lista el período de tiempo durante el cual los proveedores deben enviar confirmaciones y si Ariba Network reenvía pedidos de compra en caso de no recibir confirmaciones:

Método deenrutamiento Confirmación de proveedor Plazo para confirmación

¿Reenvía Ariba Net­work pedidos de com­pra?

cXML Response cXML en la misma conexión HTTP que el pedido de compra

5 minutos Sí, 10 veces (una vez por hora)

EDI X12 997 o EDIFACT CONTRL 72 horas No

Fax Mensaje “confirmation of receipt” del aparato de fax Inmediatamente tras enviar el fax

Sí, 10 veces (una vez por hora)

Correo electró­nico

Ninguno Ninguno No

En línea Ninguno Ninguno No

Los métodos de enrutamiento por correo electrónico y en línea no admiten las confirmaciones; Ariba Network establece inmediatamente el estado de enrutamiento de estos documentos en "enviado". Si los buzones de correo de los proveedores rechazan pedidos de compra enviados por correo electrónico, Ariba Network fija el estado de enrutamiento de esos documentos en "fallido".

Los proveedores no pueden confirmar pedidos de compra fallidos. En primer lugar deben acceder a sus cuentas Ariba Network, reenviar los pedidos de compra fallidos y devolver confirmaciones positivas.

Otras formas de confirmar pedidos de compra

Los proveedores pueden confirmar pedidos de compra "enviados" o "fallidos" enviando sus facturas. Los proveedores pueden utilizar cualquier método de facturación: en línea, cXML o EDI. Ariba Network considera las facturas como confirmaciones y establece el estado del pedido de compra como "confirmado".

Si la organización compradora descarga el estado del pedido de compra, Ariba Network envía una StatusUpdateRequest cXML para establecer el estado del pedido de compra en "confirmado".

Confirmaciones de pedido de compra global

Después de que un pedido de compra global es enviado al proveedor, mediante Ariba Network se envían las actualizaciones relativas a cualquier operación posterior de “apertura” o “cierre” en el pedido, incluido el importe disponible.

La organización compradora envía al proveedor mediante Ariba Network actualizaciones relacionadas con el importe disponible en el pedido de compra global como resultado de la reconciliación de factura o el proceso del pedido.

Si el pedido de compra global se encuentra en una jerarquía y se ha configurado para acumular gastos para un pedido de compra global maestro, entonces también se envía mediante Ariba Network una actualización relativa al

Guía de soluciones cXMLPedidos de compra

PUBLICPÚBLICO 221

Page 222: 355a de soluciones cXML - help.sap.com

importe disponible en el pedido de compra global maestro. El elemento BlanketOrderStatusUpdateRequest, utilizado para enviar actualizaciones de estado, contiene la siguiente información:

● open: Se envía con el importe disponible cuando se abre un pedido de compra global.● close: Se envía con el importe disponible cuando se cierra un pedido de compra global.● Update: Se envía cuando el importe disponible de un pedido de compra global varía como resultado de una

reconciliación de factura o del proceso del pedido de compra.● Comments: Se incluye cualquier comentario para el proveedor relacionado con la operación de "apertura" o

"cierre".● AvailableAmount: El importe restante en el pedido de compra global que aún puede ser liberado o facturado.

Documentos duplicados

Si el proveedor no envía un documento Response dentro del período de tiempo asignado del que se ha hablado anteriormente, Ariba Network reenvía el documento original. Los documentos duplicados tienen el mismo valor payloadID que el documento original; es responsabilidad del proveedor detectar duplicados.

Si el proveedor detecta un duplicado, deberá descartar los documentos anteriores y devolver un documento Response. El estado en la respuesta debería ser el mismo que en la respuesta original.

Envío de mensajes de emisión a proveedores

Los compradores pueden enviar mensajes de emisión a los proveedores mediante solicitudes de actualización de estado cXML.

Al enviar una solicitud de actualización de estado de cXML, los compradores pueden enviar mensajes de emisión a sus proveedores para informarles de los eventos que deben conocer, como programaciones de vacaciones, cierre de instalaciones de producción o la finalización de determinadas actividades como la finalización de la ejecución de planificación.

El código de estado 211 inica que el elemento Status de un documento StatusUpdateRequest para enviar un mensaje de emisión a todos los proveedores integrados. Esta es la sintaxis:

<StatusUpdateRequest> <Status code="211" text="OK">Your message here</Status> </StatusUpdateRequest>

Para recibir mensajes de emisión, los proveedores deben marcar Enviar una notificación cuando se haya recibido una solicitud de actualización de estado de emisión en la página Configuración de cuenta ConfiguraciónNotificaciones e introducir una dirección de correo electrónico.

NotaLos proveedores reciben el mensaje de emisión por correo electrónico, no en la interfase de usuario Ariba Network.

222PUBLICPÚBLICO

Guía de soluciones cXMLPedidos de compra

Page 223: 355a de soluciones cXML - help.sap.com

Confirmaciones de pedidos y avisos de expedición

Los proveedores pueden actualizar el estado del pedido de compra manualmente mediante sus cuentas Ariba Network o enviando documentos cXML a Ariba Network. Los documentos de ConfirmationRequest cXML y de ShipNoticeRequest permiten a los proveedores informar de forma programática a las organizaciones compradoras de las modificaciones de estado de los pedidos de compra mediante Ariba Network.

Estas transacciones proporcionan una confirmación de nivel de artículo y una notificación de expedición más detalladas que la simple confirmación de pedidos proporcionada por StatusUpdateRequest.

Visibilidad del estado del pedido [página 223]

Ariba Network Configuración de cuenta [página 224]

Flujo de transacciones Ariba Buyer 8.1 y posterior [página 225]

Elemento ConfirmationRequest [página 225]

Consejos de implementación y restricciones para documentos ConfirmationRequest [página 232]

Documentos OrderStatusRequest [página 241]

Documentos ShipNoticeRequest [página 243]

Visibilidad del estado del pedido

Las organizaciones compradoras, los solicitantes y los proveedores pueden visualizar el estado del pedido.

Visibilidad del estado del pedido para organizaciones compradoras

El personal de compras autorizado dentro de organizaciones compradoras puede iniciar sesión en Ariba Network y visualizar el estado el pedido.

Visibilidad del estado del pedido para solicitantes

Los solicitantes (usuarios finales) tienen acceso al estado del pedido mediante su aplicación de compras.

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

PUBLICPÚBLICO 223

Page 224: 355a de soluciones cXML - help.sap.com

La ubicación del estado del pedido visualizada por los solicitantes depende de la aplicación de compras:

Aplicación Ubicación del estado del pedido

Ariba Buyer 7.04 mediante 8.0 El estado del pedido sólo se almacena en Ariba Network, no en Ariba Buyer. Los solicitantes ven el estado del pedido realizando un punch-out de estado del pedido automáticamente en Ariba Network.

Ariba Buyer 8.1 y posterior Ariba Buyer puede descargar de forma opcional el estado del pedido periódicamente de Ariba Network. Los solicitantes ven estados del pedido en Ariba Buyer.

Visibilidad del estado del pedido para proveedores

El personal de gestión de pedidos autorizado dentro de organizaciones de proveedor pueden iniciar sesión en Ariba Network y visualizar el estado el pedido.

Ariba Network Configuración de cuentaTanto organizaciones compradoras como proveedores llevan a cabo la configuración para activar actualizaciones del estado de los pedidos.

Configuración de cuenta de organizaciones compradoras

Ariba Buyer 8.1 o posterior puede descargar documentos ConfirmationRequest y ShipNoticeRequest. Primero, las organizaciones compradoras deben ponerse en contacto con el servicio de asistencia de Ariba Network para activar sus cuentas con el fin de descargar estos tipos de documentos.

Configuración de cuenta de proveedor

Antes de enviar documentos ConfirmationRequest o ShipNoticeRequest, los proveedores deben configurar primero sus cuentas de Ariba Network para fijar el método preferido para en orientar documentos de respuesta de pedidos. Los proveedores pueden fijar el estado del pedido y la información de expedición manualmente o automáticamente.

Para fijar las actualizaciones de estado del pedido de forma programática:

1. Inicie sesión en Ariba Network como proveedor.

2. Haga clic en el icono Configuración de cuenta y seleccione Configuración Enrutamiento de pedido electrónico .

3. En la pestaña Enrutamiento de pedido electrónico, busque la sección Otros tipos de documento.4. En Documentos de respuesta de pedido, seleccione cXML.

224PUBLICPÚBLICO

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

Page 225: 355a de soluciones cXML - help.sap.com

5. Haga clic en Guardar.

NotaLos proveedores determinan la URL para publicar documentos ConfirmationRequest y ShipNoticeRequest utilizando la transacción Perfil. Para obtener más información, consulte Transacción de perfil [página 73].

Estos proveedores todavía pueden actualizar manualmente el estado del pedido modificando temporalmente la ruta de los Documentos de respuesta de pedido de cXML a en línea. Sin embargo, después de actualizar manualmente un pedido de compra, no se puede actualizar de forma subsiguiente mediante cXML.

Los proveedores también deben configurar su sistema back end para utilizar sólo el ANID de Ariba Network de su cliente en To Credentials al enviar documentos ConfirmationRequest o ShipNoticeRequest.

Además, deben asegurar que no utilizan lo siguiente en To Credentials al enviar una confirmación de pedido o avisos de expedición mediante cXML:

● El ID de Ariba Network (ANID) de la cuenta del proveedor● El ID de red (ANID) de Ariba Network - AN01000000001

Flujo de transacciones Ariba Buyer 8.1 y posteriorEsta aplicación puede descargar opcionalmente confirmaciones de pedido y avisos de expedición con la transacción GetPending. Envía una actualización de estado a Ariba Network, que la reenvía al proveedor.

El proceso es el siguiente.

1. El proveedor envía una ConfirmatioRequest o una ShipNoticeRequest. Si el documento es válido, Ariba Network responde con un código de estado 201/Aceptado en la Response.

2. Un poco más tarde, Ariba Buyer utiliza la transacción GetPending para descargar la ConfirmatioRequest o ShipNoticeRequest.

3. Si el contenido del documento pasa el procesamiento interno de la organización compradora, Ariba Buyer envía una StatusUpdateRequest a Ariba Network con el código de estado 200/OK. Ariba Network responde con el código de estado 200/OK en la Response.

4. Si el perfil cXML de proveedor indica que el proveedor admite StatusUpdateRequest, Ariba Network reenvía la StatusUpdateRequest al proveedor. El proveedor responde con el código de estado 200/OK en la Response.

Para obtener los valores de credencial para confirmaciones del pedido y avisos de expedición, consulte Credenciales obligatorias [página 49].

Elemento ConfirmationRequestLos documentos ConfirmationRequest proporcionan actualizaciones de estado detalladas de documentos OrderRequest.

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

PUBLICPÚBLICO 225

Page 226: 355a de soluciones cXML - help.sap.com

Los proveedores pueden enviar varios documentos ConfirmationRequest para un pedido, y cada ConfirmationRequest hace referencia a un documento, no a varios documentos OrderRequest. En la aplicación de compras, los solicitantes pueden ver el estado de los artículos pedidos. Tanto la organización compradora como el proveedor pueden ver todo el historial de estado y el pedido.

NotaEl documento ConfirmationRequest notifica a un cliente que el proveedor puede o no haber modificado el pedido de compra del cliente. Esto no implica que el cliente acepte estos cambios o que el pedido se pueda cumplir automáticamente según estos cambios por parte del proveedor. Acerca de cómo las organizaciones compradoras interpretan los documentos ConfirmationRequest depende de los procesos empresariales que existan fuera de la aplicación de aprovisionamiento y Ariba Network.

Los documentos ConfirmationRequest contienen tres elementos: ConfirmationHeader, OrderReference y un ConfirmationItem opcional (incluido sólo si type="detail" o "except").

Ejemplo

La siguiente ConfirmationRequest ilustra el uso del número de pedido de compra con el payloadID.

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cXML.org/schemas/cXML/1.2.014/Fulfill.dtd"><cXML payloadID="March222001_1154am" timestamp="2001-03-22 11:55:38 -0700"> <Header> <From> <Credential domain="NetworkID"> <Identity>AN0100001234</Identity> </Credential> </From> <To> <Credential domain="NetworkID"> <Identity>AN01000006789</Identity> </Credential> </To> <Sender> <Credential domain="NetworkID"> <Identity>AN0100001234</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Ecommerce Supplier</UserAgent> </Sender> </Header> <Request> <ConfirmationRequest> <ConfirmationHeader operation="new" confirmID="1234" type="accept" noticeDate="2001-02-28T10:07:00-08:00"> <Total> <Money currency="USD">139.95</Money> </Total> <Shipping> <Money currency="USD">5.00</Money> <Description xml:lang="en-US">FedEx 2-day</Description> </Shipping> <Tax> <Money currency="USD">12.45</Money> <Description xml:lang="en-US">CA State Tax</Description> </Tax> <Comments>Header Comments</Comments> </ConfirmationHeader>

226PUBLICPÚBLICO

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

Page 227: 355a de soluciones cXML - help.sap.com

<OrderReference orderID="PCO66"> <DocumentReference payloadID="[email protected]"> </DocumentReference> </OrderReference> <ConfirmationItem lineNumber="1" quantity="1"> <UnitOfMeasure>EA</UnitOfMeasure> <ConfirmationStatus quantity="1" type="accept" shipmentDate="2001-03-30T08:39:29-08:00"> <UnitOfMeasure>EA</UnitOfMeasure> <Comments>Order has been accepted. Will ship ASAP</Comments> </ConfirmationStatus> </ConfirmationItem> </ConfirmationRequest> </Request> </cXML>

Elemento ConfirmationHeader [página 227]

Elemento OrderReference [página 229]

Elemento ConfirmationItem [página 229]

Elemento ConfirmationStatus [página 230]

Elemento ConfirmationHeader

El elemento ConfirmationHeader describe el tipo y la operación de la solicitud de confirmación.

ConfirmationHeader tiene los siguientes atributos y elementos:

Atributo Descripción

confirmID Cualquier número interno utilizado por el proveedor.

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

PUBLICPÚBLICO 227

Page 228: 355a de soluciones cXML - help.sap.com

Atributo Descripción

type Tipo de solicitud de confirmación para la transacción. Pueden ser: accept, reject, except, detail, backordered, requestToPay o replace.

● type="accept", "reject" y "except" pueden aplicarse a todo el pedido de com­pra. Múltiples confirmaciones enviadas para un pedido de compra pueden hacer referencia a un artículo en línea sólo una vez, pero pueden contener varios estados para este artículo en línea. Se aceptan confirmaciones múltiples sólo si type="accept", "except" o "reject".

● type="detail" actualiza partes de un pedido de compra, como los precios, las canti­dades, las fechas de entrega, partes de rechazo, impuestos e información de expedición. Múltiples documentos ConfirmationRequest de este tipo pueden hacer referencia a un pedido de compra individual, pero no pueden hacer referencia a artículos en línea co­munes. Debe estar presente como mínimo uno de los elementos siguientes UnitPrice, Shipping, Tax, ItemIn (substitución de artículo), DeliveryDate o Contact.

● type="backordered" establece todo el pedido en estado Pedido retrasado. El provee­dor no tiene los artículos en stock, pero los enviará cuando estén disponibles.

● type="replace" sustituye todos los artículos del pedido de compra por artículos nue­vos. Los elementos ConfirmationItem deben contener elementos ConfirmationStatus sólo del tipo "detail" y deben incluir un elemento ItemIn. La aplicación de compras debe cancelar y sustituir el pedido de compra original o generar un pedido de compra de modificación que contenga estos artículos en línea nuevos.

● type="allDetail" se necesita cuando está habilitada la autorización Enhanced order confirmation integration capabilities for online and integrated suppliers. Ade­más, la autorización también requiere que la confirmación contenga elementos ConfirmationItem con información de artículo en línea del pedido.

operation Especifica si el documento es nuevo o una actualización. Puede ser "new" o "update".

● operation="new" establece el estado inicial de los artículos o de todos los pedidos.● operation="update" revisa el estado del pedido o el artículo establecido por las con­

firmaciones de pedido enviadas anteriormente. Las actualizaciones no se acumulan; cada una debe enumerar todas las cantidades de un artículo en línea (cada documento susti­tuye el documento anterior). Ariba Network rechaza las actualizaciones que no enumeran todas las líneas de pedido actualizadas previamente en la confirmación del pedido al que se hace referencia en el elemento DocumentReference. También rechaza las actuali­zaciones que agregan elementos que se han mencionado en otra ConfirmationRequest.

noticeDate Para operation="update", utilice noticeDate para especificar la fecha de la actualiza­ción (no la hora de confirmación original).

Total El valor total en dólares de todos los artículos en línea de la transacción.

El elemento Totaltambién contiene el elemento Modifications que almacena todas las modificaciones del precio original o del precio de expedición del artículo. Este elemento puede almacenar un conjunto de uno o más elementos Modification.

El elemento Modification contiene detalles de las deducciones y los cargos aplicables en el nivel de cabecera. Para obtener más información, consulte Elemento Modificaciones [página 158].

Shipping Cargo de expedición total.

Tax Impuesto total.

228PUBLICPÚBLICO

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

Page 229: 355a de soluciones cXML - help.sap.com

Todos los valores deben coincidir con el documento OrderRequest a menos que ConfirmationItem actualice el precio por unidad o la cantidad.

Los atributos type y operation de ConfirmationHeader determinan el objetivo del documento.

La visualización opcional de sólo elementos permitidos en ConfirmationHeader incluye:

● Total● Shipping● Tax● Contact● Comments● Hazard

Elemento OrderReference

El elemento OrderReference hace referencia al pedido de compra original o a una solicitud de confirmación anterior.

OrderReference tiene los atributos siguientes:

Atributo Descripción

orderID (Opcional) El número de pedido de compra asignado por Ariba Buyer.

orderDate (Opcional) Fecha en la que la organización compradora envió el pedido de compra.

DocumentReference Existe en el nivel de cabecera si la ConfirmationRequest es la respuesta inicial a una OrderRequest y también en el nivel de artículos si ConfirmationHeader operation="update".

Para operation="new", la DocumentReference en el nivel de cabecera debe hacer re­ferencia al pedido de compra. Para operation="update" o "delete", la DocumentReference en el nivel de cabecera debe hacer referencia a la ConfirmationRequest anterior.

Elemento ConfirmationItem

El elemento ConfirmationItem indica el número de artículo en línea del artículo del documento OrderRequest.

NotaConfirmationItem es obligatorio cuando está habilitada la autorización Capacidades mejoradas de la integración de confirmación de pedido para proveedores alojados e integrados. Esta autorización también exige que el elemento ConfirmationHead tenga el atributo type fijado en allDetail.

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

PUBLICPÚBLICO 229

Page 230: 355a de soluciones cXML - help.sap.com

ConfirmationItem tiene los atributos siguientes:

Atributo Descripción

lineNumber Número del artículo en línea de referencia del documento OrderRequest.

quantity Debe establecer adecuadamente si la cantidad original se debe confirmar completamente o si es actualizada.

Comments Información adicional acerca del estado del pedido general, o la parte descrita en esta confir­mación, como las condiciones de pago, detalles adicionales sobre condiciones de expedición y aclaración del estado. Entre las condiciones válidas para la información de estado se incluyen shipped e invalid.

Elemento ConfirmationStatus

El elemento ConfirmationStatus indica la acción que toma el proveedor para un artículo en línea específico.

ConfirmationStatus tiene los atributos siguientes:

Atributo Descripción

quantity La suma debe coincidir con la cantidad de ConfirmationItem.

type Acción tomada por el proveedor para el número identificado de artículo en línea. Puede ser: accept, allDetail, detail, reject, backordered, requestToPay o unknown.

● type="accept" acepta un artículo en línea particular.● type="allDetail" acepta esta parte del artículo en línea como se detalla en el conte­

nido de este elemento ConfirmationStatus. Estos contenidos totalmente describen lo que se envía. Al contrario de type="detail", este tipo de confirmación incluye toda la información conocida por el proveedor, si difiere de los datos que aparecen en el docu­mento original OrderRequest.

● type="detail" acepta una parte del artículo en línea con los cambios detallados en el elemento ConfirmationStatus. Debe estar presente como mínimo uno de los ele­mentos siguientes UnitPrice, Shipping, Tax, o ItemIn o debe estar presente el atributo deliveryDate.

● type="reject" rechaza esta parte del artículo en línea.● type="backordered" fija esta parte del artículo en línea en estado Pedido retrasado.

El proveedor no tiene los artículos en stock, pero los enviará cuando estén disponibles.● type="unknown" restablece el estado al estado predeterminado. El estado del artículo

se muestra en Ariba Network como si no se hubieran enviado confirmaciones.

shipmentDate Fecha y hora de este envío que se espera por parte del proveedor. Necesario si el tipo es accept, allDetail o detail.

deliveryDate Fecha y hora en que se espera que llegue este envío. Necesario si el tipo es accept, allDetail o detail.

No incluir si el valor coincide con requestedDeliveryDate (si lo hubiera) en el pedido de compra.

Se muestra como "Fecha de entrega estimada" en Ariba Network.

UnitPrice y Tax se prohíben si ConfirmationStatus type="unknown".

230PUBLICPÚBLICO

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

Page 231: 355a de soluciones cXML - help.sap.com

Si el pedido de compra o el pedido de compra global tienen una determinación de precios basada en la cantidad para un artículo en línea, el elemento ConfirmationStatus contiene el elemento PriceBasisQuantity [página 178].

En versiones anteriores de Ariba Network, los proveedores podían establecer el estado Pedido retrasado fijando type="unknown" e incluyendo un elemento Comments con el texto "backordered". Este método de establecer el estado Pedido retrasado ya no se admite.

El elemento ConfirmationStatus también contiene los elementos siguientes:

● Elemento Modifications [página 158]: El elemento Modification contiene detalles de las deducciones y los cargos aplicables en el nivel de artículo en línea.

● SupplierBatchID: Este elemento almacena el ID de lote proporcionado por el proveedor en el nivel de cantidad de artículo en línea para identificar el lote en el que se produjo el elemento o el producto.

Ejemplo

<ConfirmationItem quantity = "3" lineNumber = "1"> <UnitOfMeasure>DZ</UnitOfMeasure> <ConfirmationStatus type = "unknown" quantity = "1"> <UnitOfMeasure>DZ</UnitOfMeasure> </ConfirmationStatus> <ConfirmationStatus type = "accept" quantity = "2"> <UnitOfMeasure>DZ</UnitOfMeasure> <UnitPrice> <Money currency = "USD">47</Money> <Modifications> <Modification> <OriginalPrice> <Money currency = "USD">45.00</Money> </OriginalPrice> <AdditionalDeduction> <DeductionAmount> <Money currency = "USD">5.00</Money> </DeductionAmount> </AdditionalDeduction> <ModificationDetail name = "Allowance" startDate = "2012-11-19T10:15:00-08:00" endDate = "2013-11-30T10:15:00-08:00"> <Description xml:lang = "en-US">Contract Allowance</Description> </ModificationDetail> </Modification> </Modifications> </UnitPrice> <Tax> <Money currency = "USD">7.0</Money> <Description xml:lang = "en">Tax</Description> <TaxDetail category = "Other"> <TaxAmount> <Money currency = "USD">5.0</Money> </TaxAmount> </TaxDetail> <TaxDetail category = "QST"> <TaxAmount> <Money currency = "USD">2.0</Money> </TaxAmount> </TaxDetail> </Tax> </ConfirmationStatus>

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

PUBLICPÚBLICO 231

Page 232: 355a de soluciones cXML - help.sap.com

</ConfirmationItem>

Consejos de implementación y restricciones para documentos ConfirmationRequestAl trabajar con documentos ConfirmationRequest, tenga en cuenta las posibles sustituciones de artículos, cómo se gestionan los pedidos de confirmación para pedidos de cancelación y cambio y cómo se actualizan las confirmaciones de pedido.

Sustituciones de artículos en documentos ConfirmationRequest

Ariba Network permite a los proveedores enviar documentos ConfirmationRequest que sustituyan a los artículos pedidos. cXML habilita las sustituciones de artículos permitiendo elementos ItemIn en elementos ConfirmationStatus.

Ariba Network sólo muestra el ID de pieza del proveedor, el precio por unidad, la información fiscal y la expedición en línea. No se muestra la información adicional que puede haber en documentos ConfirmationRequest, como por ejemplo ID auxiliar de pieza del proveedor, ID de pieza de fabricante, descripción y comentarios.

Confirmaciones y pedidos de servicio

Los documentos ConfirmationRequest tienen las siguientes limitaciones para los pedidos de servicio que requieren una hoja de entrada de servicios:

● Sólo los artículos de nivel superior del pedido se pueden incluir en ConfirmationRequest. De lo contrario, se rechazará el documento.

● El atributo type de ConfirmationHeader debe tener uno de los siguientes valores:○ accept: Acepta el pedido.○ reject: Rechaza el pedido.○ detail: Actualiza partes de un pedido de compra, como los precios, las cantidades, las fechas de entrega,

partes de rechazo, impuestos e información de expedición.● Si el elemento ConfirmationHeader tiene type="detail", se incluyen los elementos ConfirmationItem

y ConfirmationStatus.○ Si ConfirmationItem es para un artículo de esquema, el atributo type del elemento

ConfirmationStatus debe tener uno de los siguientes valores:○ accept: Acepta esta parte del artículo en línea.○ reject: Rechaza esta parte del artículo en línea.○ unknown: Admite un OrderStatusRequest asociado (una petición de información de pedido) para

agregar un comentario acerca de un artículo de esquema.

232PUBLICPÚBLICO

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

Page 233: 355a de soluciones cXML - help.sap.com

○ Si ConfirmationItem es un artículo de material o de servicio de nivel superior, el atributo type del elemento ConfirmationStatus funciona como antes. Debe tener uno de los siguientes valores:○ accept: Acepta esta parte del artículo en línea.○ detail: Acepta una parte del artículo en línea con los cambios detallados en el elemento

ConfirmationStatus. Debe estar presente como mínimo uno de los elementos siguientes: UnitPrice, Shipping, Shipping, Tax o ItemIn, o el elemento deliveryDate.

○ reject: Rechaza esta parte del artículo en línea.○ backordered: Fija esta parte del artículo en línea en estado Pedido retrasado. El proveedor no tiene

los artículos en stock, pero los enviará cuando estén disponibles.○ unknown: Restablece el estado al estado predeterminado. El estado del artículo se muestra en Ariba

Network como si no se hubieran enviado la confirmación.

NotaSi el atributo type para ConfirmationHeader o ConfirmationStatus es un valor no admitido, se rechaza el documento.

Ejemplo

El siguiente ConfirmationRequest acepta un artículo de esquema de nivel superior del pedido y rechaza otro.

<ConfirmationRequest> <ConfirmationHeader noticeDate="2015-05-04T10:55:32-07:00" type="detail" operation="new" confirmID="OC-4500018889"> <Tax> <Money currency="USD">50.00</Money> <Description xml:lang="en-US"></Description> </Tax> </ConfirmationHeader> <OrderReference orderDate="2015-05-04T16:43:18-07:00" orderID="4500018889"> <DocumentReference payloadID="cat0504-4500018889"></DocumentReference> </OrderReference> <ConfirmationItem itemType="composite" quantity="1" lineNumber="1"> <UnitOfMeasure>SU</UnitOfMeasure> <ConfirmationStatus type="accept" quantity="1"> <UnitOfMeasure>SU</UnitOfMeasure> </ConfirmationStatus> </ConfirmationItem> <ConfirmationItem itemType="composite" quantity="1" lineNumber="2"> <UnitOfMeasure>SU</UnitOfMeasure> <ConfirmationStatus type="reject" quantity="1"> <UnitOfMeasure>SU</UnitOfMeasure> </ConfirmationStatus> </ConfirmationItem> </ConfirmationRequest>

Confirmaciones y pedidos de cancelación

Los proveedores deben comprender cómo Ariba Network procesa confirmaciones de pedido para pedidos cancelados.

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

PUBLICPÚBLICO 233

Page 234: 355a de soluciones cXML - help.sap.com

● Ariba Network rechaza documentos ConfirmationRequest para pedidos de compra cancelados.● Ariba Network no permite realizar actualizaciones en documentos ConfirmationRequest recibidos antes de

la cancelación del pedido de compra.● Los proveedores no pueden enviar documentos ConfirmationRequest para reconocer cancelaciones de

pedidos.

Confirmaciones y pedidos de cambio

Los proveedores deben comprender cómo Ariba Network procesa confirmaciones de pedido para pedidos de cambio.

● Ariba Network no permite que los proveedores rechacen pedidos originales si recibe pedidos cambiados.● De forma predeterminada, Ariba Network continúa los documentos ConfirmationRequest que se publican

antes del pedido de cambio, pero no transfiere o vincula automáticamente la ConfirmationRequest al nuevo pedido de cambio. Los compradores pueden transferir automáticamente o vincular la ConfirmationRequestal nuevo pedido de cambio activando la regla de negocio de Ariba Network Retener el estado de confirmación de artículos en línea no cambiados en pedidos de cambio.

● Un pedido de cambio aparece en la bandeja de entrada del proveedor como un pedido separado, con un indicador de versión (por ejemplo, V2). Los documentos ConfirmationRequest deben hacer referencia al DocumentReference del pedido de cambio. Ariba Network establece el estado del pedido original en "Obsoleto".

● Los proveedores no pueden rechazar el "cambio" de los pedidos originales, pero pueden rechazar, aceptar o cambiar los artículos del nuevo pedido.

● Los compradores pueden configurar su cuenta para retener información de confirmación del pedido sobre pedidos de compra cambiados con la regla Retener el estado de confirmación de artículos en línea no cambiados en pedidos de cambio.Si el comprador habilita la retención de la información del pedido confirmado sobre pedidos de cambio, las confirmaciones de pedido para pedidos de compra generan un documento ConfirmationRequest con el valor "actualizar" para el atributo Operation y el mismo atributo confirmID como la primera confirmación de pedido. La ConfirmationHeader incluye un elemento DocumentReference que contiene el payloadID de la confirmación del pedido anterior. Esto permite que el sistema ERP externo del comprador actualice la información de confirmación de pedido y el pedido de compra más que generar un segundo conjunto de datos.

Actualizaciones de confirmación del pedido

Los proveedores pueden actualizar estados de pedidos establecidos anteriormente enviando documentos ConfirmationRequest adicionales.

Para establecer el estado inicial de los artículos en línea, utilice operation="new". Para revisar artículos en línea, utilice operation="update" y enumere todos los demás artículos en línea.

Cada documento ConfirmationRequest sustituye la versión anterior de ese documento. En otras palabras, se rechaza la versión del documento anterior; los documentos ConfirmationRequest no se acumulan. Cada documento actualizado debe enumerar todos los artículos en línea que aparecieron en la pantalla anterior.

234PUBLICPÚBLICO

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

Page 235: 355a de soluciones cXML - help.sap.com

Los documentos ConfirmationRequest subsiguientes deben utilizar atributos payloadID y NoticeDate nuevos, pero el mismo atributo confirmID que la primera confirmación del pedido. Estos documentos pueden tener uno o dos elementos DocumentReference:

● Si operation="new", hace referencia al pedido de compra con un elemento DocumentReference en el nivel de artículo en línea.

● Si operation="update", hace referencia a la ConfirmationRequest anterior con una DocumentReference en el nivel de cabecera y el pedido de compra con un elemento DocumentReference en el nivel de cabecera.Ariba Network utiliza el valor de payloadID o de orderID y el atributo orderDate para que coincidan los documentos de la confirmación del pedido y del pedido de compra.Si el documento ConfirmationRequest sólo contiene el payloadID, Ariba Network sólo utiliza el payloadID para agrupar documentos. Si el documento ConfirmationRequest contiene el payloadID,orderID y la orderDate, Ariba Network utiliza el valor de los atributos orderID y orderDate para agrupar documentos.Cuando Ariba Network utiliza orderID y orderDate, la marca de tiempo de orderDate debe coincidir exactamente con la fecha y hora del pedido de compra, o de lo contrario, el documento ConfirmationRequest será erróneo.

NotaComo mejor opción, SAP Ariba recomienda a las organizaciones compradoras que reutilizan el número de pedido de compra enviar el documento ConfirmationRequest con el payloadID o el orderID y la orderDate.

● Para la confirmación de pedido, SAP Ariba Cloud Integration Gateway no requiere la referencia payloadID, pero sí es necesario el sobre cXML para el ID de carga útil. Por ejemplo, el proveedor solo necesita enviar <OrderReference orderID="1234567890"> y dejar el ID de carga útil en blanco, <DocumentReference payloadID=""/>.

Envío de información de artículo en línea adicional con confirmaciones de pedido

Una autorización agrega automáticamente información de artículo en línea a las confirmaciones de pedido enviadas.

Si los compradores solicitan al servicio de asistencia de SAP Ariba que active una de las siguientes autorizaciones, las confirmaciones de pedido se crearán o enviarán con información de artículo en línea adicional.

NotaSolo se puede activar una de estas autorizaciones.

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

PUBLICPÚBLICO 235

Page 236: 355a de soluciones cXML - help.sap.com

Autorización Métodos de confirmación de pedido compatibles

Capacidades mejoradas de integración de confirmación de pedido

Creación en Ariba NetworkCarga en archivo ExcelCarga en archivo CSV

NotaEsta autorización no agrega información de artículo en lí­nea a las confirmaciones de pedido creadas por proveedo­res integrados.

Capacidades mejoradas de la integración de confirmación de pedido para proveedores alojados e integrados

Creación en Ariba NetworkCreación por proveedores integradosCarga en archivo ExcelCarga en archivo CSV

Cuando la autorización Capacidades mejoradas de la integración de confirmación de pedido para proveedores alojados e integrados está activada y un proveedor integrado envía una confirmación de pedido sin toda la información de artículo en línea necesaria, esta autorización realiza automáticamente la siguiente acción correctiva:

1. Crear una copia de la confirmación con allDetail en el nivel de cabecera.2. Rellenar la copia con los datos que faltan, que se recuperan del pedido de compra correspondiente.3. Transferir el documento cXML enriquecido al sistema del comprador, en lugar del documento original creado

por el proveedor integrado.

Este proceso garantiza que la confirmación de pedido enviada no está bloqueada debido a los detalles incompletos del artículo en línea.

Pedido completo confirmado sin fechas de envío o entrega

Configuración de autorización

Información de confirmación de pedido enviada Valores de tipo de confirmación de pedido

Desactivado Solo información de cabecera. ConfirmationHeader.type = "accept"

Activado Información de artículo en línea del pe­dido.

ConfirmationHeader.type = "allDetail"

ConfirmationItem.ConfirmationStatus.type = "accept"

El siguiente ejemplo muestra una confirmación de pedido completa confirmada sin fechas de expedición o de entrega cuando se ha activado Capacidades mejoradas de la integración de confirmación de pedido o Capacidades mejoradas de la integración de confirmación de pedido para proveedores alojados e integrados:

<ConfirmationRequest> <ConfirmationHeader operation="new" confirmID="1234" type="allDetail" noticeDate="2017-02-28T10:07:00-08:00"> ... </ConfirmationHeader> <OrderReference orderDate="2017-02-08T10:07:00-08:00" orderID="PCO66">

236PUBLICPÚBLICO

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

Page 237: 355a de soluciones cXML - help.sap.com

<DocumentReference payloadID="payload20170520-05"> </DocumentReference> </OrderReference> <ConfirmationItem lineNumber="1" quantity="10"> <UnitOfMeasure>EA</UnitOfMeasure> <ConfirmationStatus deliveryDate="2017-05-20T08:39:29-08:00" type="accept" quantity="10"> <UnitOfMeasure>EA</UnitOfMeasure> <ItemIn lineNumber="1" quantity="10"> <ItemID> <SupplierPartID>160INSTLL</SupplierPartID> <BuyerPartID>C-160INSTLL</BuyerPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">21</Money> </UnitPrice> <Description xml:lang="en-US">N160INSTLL</Description> <UnitOfMeasure>EA</UnitOfMeasure> </ItemDetail> </ItemIn> </ConfirmationStatus> </ConfirmationItem> </ConfirmationRequest>

Pedido completo confirmado con fechas de envío o entrega

Configuración de autorización

Información de confirmación de pedido enviada Valores de tipo de confirmación de pedido

Desactivado Solo información básica (número de lí­nea, tipo de confirmación, cantidad con­firmada y unidad de medida) más fechas de expedición o entrega estimadas; el elemento ItemIn no está incluido.

ConfirmationHeader.type = "accept"

Activado Información de artículo en línea del pe­dido (incluye el elemento ItemIn)

ConfirmationHeader.type = "allDetail"

ConfirmationItem.ConfirmationStatus.type = "accept"

El siguiente ejemplo muestra una confirmación de pedido completa confirmada con fechas de expedición y de entrega cuando se ha activado Capacidades mejoradas de la integración de confirmación de pedido o Capacidades mejoradas de la integración de confirmación de pedido para proveedores alojados e integrados:

<ConfirmationRequest> <ConfirmationHeader operation="new" confirmID="1234" type="allDetail" noticeDate="2017-02-28T10:07:00-08:00"> ... </ConfirmationHeader> <OrderReference orderDate="2017-02-08T10:07:00-08:00" orderID="PCO66"> <DocumentReference payloadID="payload20170520-05"> </DocumentReference> </OrderReference> <ConfirmationItem lineNumber="1" quantity="10"> <UnitOfMeasure>EA</UnitOfMeasure> <ConfirmationStatus deliveryDate="2017-05-24T08:39:29-08:00"

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

PUBLICPÚBLICO 237

Page 238: 355a de soluciones cXML - help.sap.com

shippingDate="2017-05-23T08:39:29-08:00" type="accept" quantity="10"> <UnitOfMeasure>EA</UnitOfMeasure> <ItemIn lineNumber="1" quantity="10"> <ItemID> <SupplierPartID>160INSTLL</SupplierPartID> <BuyerPartID>C-160INSTLL</BuyerPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">21</Money> </UnitPrice> <Description xml:lang="en-US">N160INSTLL</Description> <UnitOfMeasure>EA</UnitOfMeasure> </ItemDetail> </ItemIn> </ConfirmationStatus> </ConfirmationItem> </ConfirmationRequest>

Pedido completo rechazado

Configuración de autorización

Información de confirmación de pedido enviada Valores de tipo de confirmación de pedido

Desactivado Solo información de cabecera. ConfirmationHeader.type = "reject"

Activado Información de artículo en línea del pe­dido.

ConfirmationHeader.type = "allDetail"

ConfirmationItem.ConfirmationStatus.type = "reject"

El siguiente ejemplo muestra una confirmación de pedido que rechaza un pedido completo cuando se ha activado Capacidades mejoradas de la integración de confirmación de pedido o Capacidades mejoradas de la integración de confirmación de pedido para proveedores alojados e integrados:

<ConfirmationRequest> <ConfirmationHeader operation="new" confirmID="1234" type="allDetail" noticeDate="2017-02-28T10:07:00-08:00"> ... </ConfirmationHeader> <OrderReference orderDate="2017-02-08T10:07:00-08:00" orderID="PCO66"> <DocumentReference payloadID="payload20170520-05"> </DocumentReference> </OrderReference> <ConfirmationItem lineNumber="1" quantity="10"> <UnitOfMeasure>EA</UnitOfMeasure> <ConfirmationStatus deliveryDate="2017-05-24T08:39:29-08:00" shippingDate="2017-05-23T08:39:29-08:00" type="reject" quantity="10"> <UnitOfMeasure>EA</UnitOfMeasure> <ItemIn lineNumber="1" quantity="10"> <ItemID> <SupplierPartID>160INSTLL</SupplierPartID> <BuyerPartID>C-160INSTLL</BuyerPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">21</Money>

238PUBLICPÚBLICO

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

Page 239: 355a de soluciones cXML - help.sap.com

</UnitPrice> <Description xml:lang="en-US">N160INSTLL</Description> <UnitOfMeasure>EA</UnitOfMeasure> </ItemDetail> </ItemIn> </ConfirmationStatus> </ConfirmationItem> </ConfirmationRequest>

Pedido confirmado actualizando artículos en línea: confirmado tal cual, retrasado o rechazado

Configuración de autorización

Información de confirmación de pedido enviada Valores de tipo de confirmación de pedido

Desactivado Solo información básica (número de lí­nea, tipo de confirmación, cantidad con­firmada y unidad de medida); el ele­mento ItemIn no está incluido.

ConfirmationHeader.type = "detail"

ConfirmationItem.ConfirmationStatus.type = "accept"

ConfirmationItem.ConfirmationStatus.type = "reject"

ConfirmationItem.ConfirmationStatus.type = "backordered"

ConfirmationItem.ConfirmationStatus.type = "unknown"

Activado Información de artículo en línea del pe­dido (incluye el elemento ItemIn), salvo los artículos con el tipo de estado de confirmación unknown.

ConfirmationHeader.type = "allDetail"

ConfirmationItem.ConfirmationStatus.type = "accept"

ConfirmationItem.ConfirmationStatus.type = "reject"

ConfirmationItem.ConfirmationStatus.type = "backordered"

ConfirmationItem.ConfirmationStatus.type = "unknown"

El siguiente ejemplo muestra una confirmación de pedido que retrasa un artículo cuando se ha activado Capacidades mejoradas de la integración de confirmación de pedido o Capacidades mejoradas de la integración de confirmación de pedido para proveedores alojados e integrados:

<ConfirmationRequest> <ConfirmationHeader operation="new" confirmID="1234" type="allDetail" noticeDate="2017-02-28T10:07:00-08:00"> ... </ConfirmationHeader> <OrderReference orderDate="2017-02-08T10:07:00-08:00" orderID="PCO66"> <DocumentReference payloadID="payload20170520-05"> </DocumentReference> </OrderReference> <ConfirmationItem lineNumber="1" quantity="10">

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

PUBLICPÚBLICO 239

Page 240: 355a de soluciones cXML - help.sap.com

<UnitOfMeasure>EA</UnitOfMeasure> <ConfirmationStatus deliveryDate="2017-05-24T08:39:29-08:00" shippingDate="2017-05-23T08:39:29-08:00" type="backordered" quantity="10"> <UnitOfMeasure>EA</UnitOfMeasure> <ItemIn lineNumber="1" quantity="10"> <ItemID> <SupplierPartID>160INSTLL</SupplierPartID> <BuyerPartID>C-160INSTLL</BuyerPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">21</Money> </UnitPrice> <Description xml:lang="en-US">N160INSTLL</Description> <UnitOfMeasure>EA</UnitOfMeasure> </ItemDetail> </ItemIn> </ConfirmationStatus> </ConfirmationItem> </ConfirmationRequest>

Pedido confirmado actualizando artículos en línea: confirmado con cambios

Configuración de autorización

Información de confirmación de pedido enviada Valores de tipo de confirmación de pedido

Desactivado Solo los elementos cXML que contienen campos que el proveedor ha cambiado en la confirmación de pedido (el ele­mento ItemIn se incluye solo si es ne­cesario para contener un valor cam­biado).

ConfirmationHeader.type = "detail"

ConfirmationItem.ConfirmationStatus.type = "detail"

Activado Información de artículo en línea del pe­dido.

ConfirmationHeader.type = "allDetail"

ConfirmationItem.ConfirmationStatus.type = "allDetail"

ConfirmationItem.ConfirmationStatus.type = "unknown"

El siguiente ejemplo muestra una confirmación de pedido que confirma un artículo con cambios cuando se ha activado Capacidades mejoradas de la integración de confirmación de pedido o Capacidades mejoradas de la integración de confirmación de pedido para proveedores alojados e integrados:

<ConfirmationRequest> <ConfirmationHeader operation="new" confirmID="1234" type="allDetail" noticeDate="2017-02-28T10:07:00-08:00"> ... </ConfirmationHeader> <OrderReference orderDate="2017-02-08T10:07:00-08:00" orderID="PCO66"> <DocumentReference payloadID="payload20170520-05"> </DocumentReference> </OrderReference> <ConfirmationItem lineNumber="1" quantity="10"> <UnitOfMeasure>EA</UnitOfMeasure>

240PUBLICPÚBLICO

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

Page 241: 355a de soluciones cXML - help.sap.com

<ConfirmationStatus deliveryDate="2017-05-24T08:39:29-08:00" shippingDate="2017-05-23T08:39:29-08:00" type="allDetail" quantity="10"> <UnitOfMeasure>EA</UnitOfMeasure> <ItemIn lineNumber="1" quantity="10"> <ItemID> <SupplierPartID>160INSTLL</SupplierPartID> <BuyerPartID>C-160INSTLL</BuyerPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">21</Money> </UnitPrice> <Description xml:lang="en-US">N160INSTLL</Description> <UnitOfMeasure>EA</UnitOfMeasure> </ItemDetail> </ItemIn> </ConfirmationStatus> </ConfirmationItem> </ConfirmationRequest>

Documentos OrderStatusRequestLos compradores utilizan el documento OrderStatusRequest para solicitar a los proveedores los informes de estado sobre los pedidos sin cumplir. Los compradores pueden solicitar información a los proveedores sobre el estado del pedido, la fecha de entrega, la ubicación actual de los artículos expedidos o cualquier otra información relacionada con los pedidos de compra que hayan enviado anteriormente.

Ejemplo

<OrderStatusRequestHeader orderStatusRequestID="order02_08.20" orderStatusRequestDate="2013-02-06T16:09:26-08:00"> <OrderReference orderID="order02_08.20" orderDate="2013-02-06T16:09:26-08:00"> <DocumentReference payloadID="[email protected]"/> </OrderReference> <Contact role="soldTo" addressID=’AA20’> <Name xml:lang="en">Lisa Dollar</Name> <PostalAddress name=’default’> <DeliverTo>Lisa Dollar</DeliverTo> <Street>100 Castro Street</Street> <City>Mountain View</City> <State>CA</State> <PostalCode>95035</PostalCode> <Country isoCountryCode="US">United States</Country> <Extrinsic name="POBox"></Extrinsic> <Extrinsic name="houseNumber"></Extrinsic> <Extrinsic name="building"></Extrinsic> </PostalAddress> <Email name=’default’>[email protected]</Email> <Phone name=’work’> <TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode>650</AreaOrCityCode> <Number>9990000</Number> </TelephoneNumber>

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

PUBLICPÚBLICO 241

Page 242: 355a de soluciones cXML - help.sap.com

</Phone> </Contact> <Contact role=’from’ addressID=’0030105956’> <Name xml:lang=”en”>Lisa Dollar</Name> <PostalAddressname=’default’> <DeliverTo>Lisa Dollar</DeliverTo> <Street>100 Castro Street</Street> <City>Mountain View</City> <State>CA</State> <PostalCode>95035</PostalCode> <Country isoCountryCode’’US’>United States</Country> </PostalAddress> <Email name=’default’>[email protected]</Email> <Phone name=’work’> <TelephoneNumber> <CountryCode isoCountryCode=’US’>1</CountryCode> <AreaOrCityCode>650</AreaOrCityCode> <Number>9990000</Number> </TelephoneNumber> </Phone> </Contact> <Comments>Is there any news about our order?</Comments> </OrderStatusRequestHeader>

Elemento OrderStatusRequestHeader [página 242]

Elemento OrderStatusRequestItem [página 242]

Elemento OrderStatusRequestHeader

El elemento OrderStatusRequestHeader contiene información de nivel de cabecera para el documento OrderStatusRequest. Contiene la información de referencia para el OrderStatusRequestID y la OrderStatusRequestDate enviados por el comprador.

Este elemento tiene los elementos siguientes:

● OrderReference or OrderIDInfo● Contact● Comments● Extrinsic

El elemento OrderStatusRequestHeader tiene los siguientes atributos:

● orderStatusRequestID● orderStatusRequestDate

Elemento OrderStatusRequestItem

El elemento OrderStatusRequestItem almacena información respecto a un artículo en línea específico.

OrderStatusRequestItem tiene los siguientes elementos:

● ItemReference● Comments

242PUBLICPÚBLICO

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

Page 243: 355a de soluciones cXML - help.sap.com

El elemento ItemReference contiene el atributo lineNumber obligatorio.

La ConfirmationRequest puede incluir la OrderStatusRequestReference y el OrderStatusRequestID como elementos opcionales para hacer referencia explícitamente a la OrderStatusRequest asociada con la ConfirmationRequest.

Ejemplo

En el ejemplo siguiente se muestra un elemento OrderStatusRequestItem:

<OrderStatusRequestItem> <ItemReference lineNumber’’10’> <ItemID> <SupplierPartID>1023</SupplierPartID> </ItemID> </ItemReference> <Comments>We did not receive the requested quantity.</Comments> </OrderStatusRequestItem>

Documentos ShipNoticeRequestLos proveedores pueden fijar el estado de expedición de los artículos en línea del pedido de compra enviando documentos ShipNoticeRequest cXML.

Los documentos ShipNoticeRequest son avisos de expedición avanzados que proporcionan información de expedición detallada para artículos en pedidos de compra. Los proveedores pueden enviar estos documentos antes o después de expedir artículos. Ariba Network recibe documentos ShipNoticeRequest, los valida contra los DTD cXML y aplica la información contenida en ellos a los artículos en línea afectados.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cXML.org/schemas/cXML/1.2.014/Fulfill.dtd"><cXML payloadID="[email protected]"xml:lang="en-CA" timestamp="2001-10-14T08:39:29-08:00"> <Header> <From> <Credential domain="DUNS"> <Identity>123456789</Identity> </Credential> </From> <To> <Credential domain="NetworkID"> <Identity>AN01000002792</Identity> </Credential> </To> <Sender> <Credential domain="DUNS"> <Identity>123456789</Identity>

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

PUBLICPÚBLICO 243

Page 244: 355a de soluciones cXML - help.sap.com

<SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Ecommerce Supplier</UserAgent> </Sender> </Header> <Request> <ShipNoticeRequest> <ShipNoticeHeader shipmentType="planned" shipmentID="S89823-123" operation="new" noticeDate="2001-10-14" shipmentDate="2001-10-14T08:30:19-08:00" deliveryDate="2001-10-18T09:00:00-08:00"> <Contact role="shipFrom"> <Name xml:lang="en-CA">XYZ Warehouse Inc.</Name> <PostalAddress> <Street>9966 Mercury Liquid Center</Street> <City>Sunnyvale</City> <State>CA</State> <PostalCode>94086</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> <Phone> <TelephoneNumber> <CountryCode isoCountryCode="CA">1</CountryCode> <AreaOrCityCode>800</AreaOrCityCode> <Number>5555555</Number> </TelephoneNumber> </Phone> </Contact> <Comments xml:lang="en-CA">Single shipment.</Comments> <Comments type="ReasonForShipment" xml:lang="en-US">Low availability at warehouse</Comments> <Comments type="TransitDirection" xml:lang="en-US">East</Comments> <Comments xml:lang="en-US">As per the terms</Comments> <TermsOfDelivery> <TermsOfDeliveryCode value=”PriceCondition”/> <ShippingPaymentMethod value=”AdvanceCollect”/> <TransportTerms value=”Other”>Contract Terms</TransportTerms> <Address> <Name xml:lang=”en-US”>SNV</Name> <PostalAddress name=”default”> <Street>123 Anystreet</Street> <City>Sunnyvale</City> <State>AL</State> <PostalCode>35762</PostalCode> <Country isoCountryCode=”US”>United States</Country> </PostalAddress> </Address> <Comments xml:lang=”en-US” type=”Transport”>As per the contract</Comments> <Comments xml:lang=”en-US” type=”TermsOfDelivery”>Delivery at the doorstep</Comments> </Terms Of Delivery> </ShipNoticeHeader> <ShipControl> <CarrierIdentifier domain="SCAC">FDE</CarrierIdentifier> <CarrierIdentifier domain="companyName">FedEx</CarrierIdentifier> <ShipmentIdentifier>8202 8261 3294</ShipmentIdentifier> </ShipControl> <ShipNoticePortion> <OrderReference orderID="PCO66"> <DocumentReference payloadID="[email protected]"> </DocumentReference> </OrderReference> <ShipNoticeItem quantity="1" lineNumber="1"> <UnitOfMeasure>EA</UnitOfMeasure> </ShipNoticeItem> </ShipNoticePortion>

244PUBLICPÚBLICO

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

Page 245: 355a de soluciones cXML - help.sap.com

</ShipNoticeRequest> </Request> </cXML>

Consejos de implementación y restricciones para ShipNoticeRequest [página 245]

Editar un aviso de expedición con cXML [página 250]

Cómo cancelar un aviso de expedición mediante cXML [página 251]

Consejos de implementación y restricciones para ShipNoticeRequest

Los elementos y los atributos de ShipNoticeRequest tienen varios requisitos y, en algunos casos, restricciones.

Atributo payloadID de ShipNoticeRequest [página 245]

Atributo payloadID de DocumentReference [página 246]

Atributo shipmentID [página 246]

Elemento ServiceLevel [página 246]

Elemento ShipControl [página 246]

Elemento PackageIdentification [página 247]

Elemento Packaging [página 247]

Elemento ShipNoticeItem [página 248]

Atributo shipNoticeLineNumber [página 248]

Elemento TransportInformation [página 248]

Elemento SupplierBatchID [página 248]

Elemento TermsofDelivery [página 248]

Avisos de expedición y pedidos de cancelación y cambio [página 248]

Extrínsecos de ShipNoticeHeader [página 248]

Dimensiones de embalaje de aviso de expedición [página 249]

Números de serie y etiquetas de activo en avisos de expedición [página 250]

Restricciones de ShipNoticeRequest [página 250]

Atributo payloadID de ShipNoticeRequest

El payloadID en la cabecera de la ShipNoticeRequest debe ser unívoco.

Consulte la Guía de referencia de cXML en http://www.cxml.org para el formato payloadID.

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

PUBLICPÚBLICO 245

Page 246: 355a de soluciones cXML - help.sap.com

Atributo payloadID de DocumentReference

Al igual que la transacción ConfirmationRequest, el DocumentReference payloadID debe coincidir con el payloadID de la OrderRequest. Ariba Network utiliza el valor de payloadID o de orderID y el atributo orderDate para agrupar documentos.

Si el documento ShipNoticeRequest sólo contiene el payloadID, Ariba Network sólo utiliza el payloadID para agrupar documentos. Si el documento ShipNoticeRequest contiene el payloadID,orderID y la orderDate, Ariba Network utiliza el valor de los atributos orderID y orderDate para agrupar documentos.

Si el atributo orderID y orderDate se utiliza para agrupar documentos, para la orderDate se concede una tolerancia de +1 o -1 día.

NotaComo mejor opción, SAP Ariba recomienda a las organizaciones compradoras que reutilizan el número de pedido de compra enviar el documento ShipNoticeRequest con el payloadID o el orderID y la orderDate.

El orderID es un atributo opcional.

NotaPara la solicitud de aviso de expedición, SAP Ariba Cloud Integration Gateway no requiere la referencia payloadID, pero sí es necesario el sobre cXML para el ID de carga útil. Por ejemplo, el proveedor solo necesita enviar <OrderID="1234567890"> y dejar el ID de carga útil en blanco, <DocumentReference payloadID=""/>.

Atributo shipmentID

El atributo shipmentID es obligatorio.

Elemento ServiceLevel

El elemento ServiceLevel es opcional. Si lo incluye, se necesitan una o más cadenas específicas de idioma

Elemento ShipControl

El elemento ShipControl describe segmentos de viaje bajo control de un transportista individual. Proporciona información de seguimiento que las organizaciones compradoras pueden utilizar para recuperar información acerca de la expedición. El elemento Route describe segmentos de tránsito (modos) bajo control de un transportista.

246PUBLICPÚBLICO

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

Page 247: 355a de soluciones cXML - help.sap.com

Si los proveedores especifican el nombre de un transportista reconocido por Ariba Network, muestra un hiperenlace para realizar el seguimiento de la expedición en el sitio web del transportista. Ariba Network utiliza nombres de transportista en el dominio companyName:

<ShipControl> <CarrierIdentifier domain="companyName">FedEx</CarrierIdentifier> <ShipmentIdentifier>8202 8261 1194</ShipmentIdentifier> </ShipControl>

Ariba Network reconoce los siguientes nombres de transportista:

● Airborne Express● Consolidated Freightways● DHL● EGL Eagle Global Logistics● EmeryWorldwide● FedEx● Menlo/IBM● Purolator● Purolator Courier● Roadway Express● UAL Cargo● UPS● US Postal Service● Velocity Express● Yellow Freight

El elemento ShipControl también almacena el elemento ShipmentIdentifier para almacenar el número de seguimiento y la URL de seguimiento de la expedición.

Elemento PackageIdentification

El elemento PackageIdentification reside en el elemento ShipControl. Los avisos de expedición tienen sólo un ShipmentIdentifier por transportista. La PackageIdentification contiene un rango inclusivo de números que aparece en partes (por ejemplo, cajas, palés o palés planos) de la expedición.

Elemento Packaging

El elemento Packaging reside en el elemento ShipNoticeItem. Contiene códigos de embalaje (cero o más cadenas específicas de configuración local) y dimensiones para el embalaje de un artículo. Las únicas dimensiones admitidas son la longitud, la anchura, la altura, el peso y el volumen.

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

PUBLICPÚBLICO 247

Page 248: 355a de soluciones cXML - help.sap.com

Elemento ShipNoticeItem

Este ShipNoticeItem almacena la cantidad y el número de línea del artículo en línea.

Atributo shipNoticeLineNumber

El atributo ShipNoticeLineNumber se incluye en el elemento ShipNoticeItem y almacena los números de línea de los avisos de expedición.

Elemento TransportInformation

Para obtener más información, consulte Elemento TransportInformation [página 151].

Elemento SupplierBatchID

Para obtener más información, consulte Elemento ConfirmationStatus [página 230].

Elemento TermsofDelivery

Puede agregar el elemento TermsofDeliveryal elemento ShipNoticeItem para especificar condiciones de entrega en el nivel del artículo en línea.

Avisos de expedición y pedidos de cancelación y cambio

Si los pedidos de compra están marcados como Expedidos o Expedidos parcialmente, Ariba Network rechaza cualquier pedido de cancelación o cambio.

Extrínsecos de ShipNoticeHeader

ShipNoticeHeader tiene diferentes extrínsecos que pueden utilizarse para indicar información sobre paquetes y cargo.

248PUBLICPÚBLICO

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

Page 249: 355a de soluciones cXML - help.sap.com

ShipNoticeHeader tiene los siguientes extrínsecos cXML:

Extrínseco Descripción

isDivisibleLoad Indica si el cargo se ha separado en unidades de pesos legales sin afectar la integridad fí­sica de la carga.

totalOfPackages Número total calculado de paquetes en la expedición.

isSensitiveLoad Indica si parte del cargo es perecedero o si es sensible a ciertas temperaturas.

El ejemplo siguiente muestra los extrínseco de ShipNoticeHeader.

<ShipNoticeHeader noticeDate="2017-05-17T11:17:52-07:00" operation="new" shipmentID="asn-2345678"> <Contact role="shipFrom"> ... </Contact> <Contact role="shipTo"> ... </Contact> <Hazard> <Classification domain="UNDG">1091</Classification> </Hazard> <Packaging> ... </Packaging> ... <Extrinsic name="isDivisibleLoad"> Yes </Extrinsic> <Extrinsic name="isSensitiveLoad"> Yes </Extrinsic> <Extrinsic name="totalOfPackages"> 2 </Extrinsic> </ShipNoticeHeader>

Dimensiones de embalaje de aviso de expedición

Puede utilizar Dimension@type para especificar las dimensiones de embalaje , es decir, el ancho, el largo y el alto en un aviso de expedición.

Los ejemplos siguientes muestran cómo utilizar Dimension@type para especificar las dimensiones de embalaje en un aviso de expedición:

<Packaging> <Dimension type="length" quantity="8"> <UnitOfMeasure>m</UnitOfMeasure> </Dimension> <Dimension type="width" quantity="5"> <UnitOfMeasure>m</UnitOfMeasure> </Dimension> <Dimension type="height" quantity="2"> <UnitOfMeasure>m</UnitOfMeasure> </Dimension>

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

PUBLICPÚBLICO 249

Page 250: 355a de soluciones cXML - help.sap.com

</Packaging>

Números de serie y etiquetas de activo en avisos de expedición

Los proveedores pueden proporcionar números de serie a las organizaciones compradoras en avisos de expedición. De forma alternativa, las organizaciones compradoras pueden asignar previamente un rango de números de activos a cada proveedor.

Por ejemplo, el proveedor puede ofrecer la impresión de códigos de barras para el rango de números y asignarlos a los productos expedidos. Si los proveedores que utilizan la conversión de PO introducen información de la etiqueta de activos o del número de serie, Ariba Network la coloca en el elemento correcto.

Los proveedores generan etiquetas AssetInfo en el documento ShipNoticeRequest.

Ejemplo

<ShipNoticeItem lineNumber="10" quantity="2.000"> <AssetInfo tagNumber="111" serialNumber="SN5187" location="Bob's Office"/> <AssetInfo tagNumber="112" serialNumber="SN5188" location="Anthony's Office"/> <UnitOfMeasure>EA</UnitOfMeasure> </ShipNoticeItem>

Restricciones de ShipNoticeRequest

Observe las restricciones de Ariba Network al utilizar ShipNoticeRequest.

● Actualmente, no se admiten varios elementos ShipControl en una ShipNoticeRequest. Envíe una ShipNoticeRequest separada para cada envío.

● Actualmente, no se admiten varios elementos ShipNoticePortion en una ShipNoticeRequest. Si un envío contiene artículos de varios pedidos, se debe enviar una ShipNoticeRequest para cada pedido.

Editar un aviso de expedición con cXML

Puede revisar un aviso de expedición realizando varios cambios en él y enviándolo después de nuevo.

Para editar un aviso de expedición realice los cambios siguientes a cXML y, a continuación, envíelo de nuevo:

● Cambiar el ID de carga útil.● Cambiar la operación a "actualizar"● Realice los cambios deseados en el contenido del aviso de expedición.

250PUBLICPÚBLICO

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

Page 251: 355a de soluciones cXML - help.sap.com

NotaNo cambie el ID del aviso de expedición (shipmentID), que debe ser el mismo que en el aviso de expedición original.

● Agregue una referencia de documento al aviso de expedición original.

Ejemplo

<ShipNoticeHeader noticeDate="2019-01-10T12:45:22-08:00" operation="update" shipmentID="SH-1-2"> <DocumentReference payloadID="[email protected]">

Cómo cancelar un aviso de expedición mediante cXML

Puede cancelar un aviso de expedición realizando varios cambios al mismo y enviándolo después de nuevo.

Para cancelar un aviso de expedición realice los cambios siguientes a cXML y, a continuación, envíelo de nuevo:

● Cambiar el ID de carga útil● Cambiar la operación que debe suprimirse● Cambiar el ID de aviso de expedición (ID de envío) añadiendo '_1’ al ID de aviso de expedición antiguo.● Agregue una referencia de documento al aviso de expedición antiguo

Ejemplo

<ShipNoticeHeader noticeDate="2016-08-11T16:42:50+03:00" operation="delete" shipmentID="SH-1-2_1"><DocumentReference payloadID="[email protected]">

Guía de soluciones cXMLConfirmaciones de pedidos y avisos de expedición

PUBLICPÚBLICO 251

Page 252: 355a de soluciones cXML - help.sap.com

Hojas de entrada de servicios

Una hoja de entrada de servicios es una actualización de estado para un pedido de compra que contiene artículos en línea para solicitudes de servicio. Proporciona una descripción más detallada de servicios que unaStatusUpdateRequest oOrderConfirmationRequest.

Los proveedores no ven la funcionalidad Services Invoicing en sus cuentas hasta que reciben su primer pedido de servicio. Cuando lo reciben, Services Invoicing se activa automáticamente y los proveedores pueden crear hojas de entrada de servicios.

Los proveedores pueden actualizar el estado del pedido de compra bien manualmente mediante sus Ariba Network cuentas o bien enviando documentos cXML a Ariba Network.

El documento cXML ServiceEntryRequest permite a los proveedores informar de forma programada a las organizaciones compradoras de los cambios de estado en pedidos de compra mediante Ariba Network. Estas transacciones pueden incluir tanto bienes materiales como artículos de servicio que el proveedor ha agregado durante la realización del servicio.

NotaAriba Network no admite la creación de documentos ServiceEntryRequest contra pedidos de compra globales (ordertype="blanket"). Sin embargo, sí admite la creación de hojas de entrada de servicios contra pedidos de compra normales (ordertype="regular") con líneas de pedido global sin planificar con un importe máximo definido (deben incluir el elemento <BlanketItemDetail MaxAmount=" ">, con el MaxAmount definido).

Visibilidad del estado del pedido de la hoja de entrada de servicios [página 252]

Configuración de la cuenta de Ariba Network para los documentos ServiceEntryRequest [página 253]

Documentos ServiceEntryRequest [página 254]

Actualizaciones de estado de ServiceEntryRequest [página 260]

Visibilidad del estado del pedido de la hoja de entrada de serviciosLas organizaciones compradoras, los solicitantes y los proveedores pueden visualizar el estado del pedido.

Visibilidad del estado del pedido para organizaciones compradorasEl personal de compras autorizado dentro de organizaciones compradoras pueden iniciar sesión en Ariba Network y visualizar el estado el pedido.

252PUBLICPÚBLICO

Guía de soluciones cXMLHojas de entrada de servicios

Page 253: 355a de soluciones cXML - help.sap.com

Visibilidad del estado del pedido para solicitantes

Los solicitantes (usuarios finales) tienen acceso al estado del pedido a través de sus aplicaciones de compras.

Visibilidad del estado del pedido para proveedores

El personal de gestión de pedidos autorizado dentro de organizaciones de proveedor pueden iniciar sesión en Ariba Network y visualizar el estado el pedido.

Configuración de la cuenta de Ariba Network para los documentos ServiceEntryRequestTanto organizaciones compradoras como proveedores llevan a cabo la configuración para activar actualizaciones del estado de los pedidos.

Configuración de ServiceEntryRequest para organizaciones compradoras

Las organizaciones compradoras deben en primer lugar ponerse en contacto con el servicio de asistencia Ariba Network para activar sus cuentas para la descarga de documentos ServiceEntryRequest.

Configuración de ServiceEntryRequest para proveedores

Antes de enviar documentos ServiceEntryRequest, los proveedores deben configurar sus cuentas Ariba Network para fijar su método preferido para el envío de documentos. Los proveedores pueden fijar estados de pedidos e información de expedición manual o automáticamente; ambos métodos no pueden utilizarse simultáneamente.

Para fijar actualizaciones del estado de los pedidos de forma programática, los proveedores acceden a sus cuentas Ariba Network, van al área Configuración y fijan Método preferido para el envío de documentos en cXML. También deben determinar la URL para la publicación de documentos ServiceEntryREquest utilizando la transacción de perfil.

Los proveedores deben configurar su sistema back end para utilizar únicamente el ID de Ariba Network de su cliente en To Credentials durante el envío de documentos ConfirmationRequest o ShipNoticeRequest y no su propio ID o el ID de Ariba Network (AN01000000001).

Guía de soluciones cXMLHojas de entrada de servicios

PUBLICPÚBLICO 253

Page 254: 355a de soluciones cXML - help.sap.com

Información relacionada

Transacción Perfil [página 73]

Documentos ServiceEntryRequestUn documento ServiceEntryRequest es un documento creado por un proveedor en un lugar de trabajo para proporcionar información detallada sobre servicios prestados, incluidos los bienes materiales utilizados durante el servicio. Un proveedor lo envía en respuesta a una línea de servicio en un pedido de compra que requiere hojas de entrada de servicios.

Los proveedores envían esos documentos tras prestar servicios. Para pedidos de servicios grandes o con varias piezas, los proveedores pueden crear varias hojas de entrada de servicios para describir distintas piezas de un pedido de servicio o servicios prestados durante diferentes períodos de tiempo para una única línea. Ariba Network recibe documentos ServiceEntryRequest, los valida contra los DTD cXML y aplica la información contenida en ellos a los artículos en línea afectados.

Los proveedores pueden fijar el estado "servido" para los artículos en línea del pedido de compra enviando documentos cXML ServiceEntryRequest. Las organizaciones compradoras pueden ver el estado del artículo en línea actualizado.

Consejos de implementación y restricciones para ServiceEntryRequest [página 254]

Hojas de entrada de servicios generadas automáticamente [página 256]

Hojas de entrada de servicios y pedidos de cancelación y cambio [página 257]

Ejemplo ServiceEntryRequest [página 258]

Consejos de implementación y restricciones para ServiceEntryRequest

ServiceEntryRequest tiene algunos elementos y atributos obligatorios y algunas restricciones.

Atributo payloadID en ServiceEntryRequest

El payloadID en la cabecera de la ServiceEntryRequest debe ser unívoco.

Referencias adicionales

● Guía de referencia de cXML en este manual http://www.cxml.org

254PUBLICPÚBLICO

Guía de soluciones cXMLHojas de entrada de servicios

Page 255: 355a de soluciones cXML - help.sap.com

Atributo payloadID de DocumentReference

Al igual que la transacción ConfirmationRequest, el payloadID de DocumentReference debe coincidir con el payloadID de la OrderRequest. Ariba Network utiliza el valor de payloadID o de orderID y el atributo orderDate para agrupar documentos.

Si el documento ServiceEntryREquest sólo contiene el payloadID, Ariba Network sólo utiliza el payloadID para agrupar documentos. Si el documento ServiceEntryRequest contiene el payloadID,orderID y la orderDate, Ariba Network utiliza el valor de los atributos orderID y orderDate para agrupar documentos.

Si el atributo orderID y orderDate se utiliza para agrupar documentos, para la orderDate se concede una tolerancia de +1 o -1 día.

NotaComo mejor opción, SAP Ariba recomienda a las organizaciones compradoras que reutilizan el número de pedido de compra enviar el documento ServiceEntryRequest con el payloadID o el orderID y la orderDate.

El orderID es un atributo opcional.

Cada línea de servicio DocumentReference en una ServiceEntryRequest debe hacer referencia a la misma OrderRequest.

Atributo ServiceEntryID

El ServiceEntryID en la cabecera de la ServiceEntryRequest debe ser unívoco.

Elemento PartnerContact

El elemento PartnerContact en la cabecera de la ServiceEntryRequest define las partes implicadas en la hoja de entrada de servicios. Por lo general identifica el técnico de campo del comprador, el contratista de campo del proveedor y el responsable de aprobación del comprador.

● <Contact role="fieldEngineer"> especifica el técnico de campo del comprador que supervisa el servicio.

● <Contact role="fieldContractor">> especifica el contratista de campo del proveedor que presta el servicio.

● <Contact role="requester">> especifica el usuario comprador que aprueba la hoja de entrada de servicios.

En Ariba Network puede fijar una regla de transacción para la hoja de entrada de servicios para exigir a los proveedores que proporcionen información de contacto de esas partes con el fin de facilitar la colaboración y resolver problemas. Consulte la Guía de administración del comprador Ariba Network para obtener información adicional.

Guía de soluciones cXMLHojas de entrada de servicios

PUBLICPÚBLICO 255

Page 256: 355a de soluciones cXML - help.sap.com

Elemento Period

El elemento Period en la cabecera de una ServiceEntryRequest define la fecha de inicio y de fin del período de servicio a lo largo del cual el proveedor ha prestado el servicio. Este elemento es opcional pero si se proporciona especifica las fechas de inicio y de fin predeterminadas para todos los artículos en línea que aparecen en la hoja de entrada de servicios.

Hojas de entrada de servicios generadas automáticamente

Para cualquier pedido de servicio, los proveedores pueden omitir la generación manual de la hoja de entrada de servicios, generar directamente facturas de servicios para cada línea de servicio y permitir que Ariba Network genere automáticamente las correspondientes hojas de entrada de servicios. Una hoja de entradas de servicios generada automáticamente tiene elementos cXML adicionales, los mismos que aparecen en una factura de servicios.

Las tablas de más abajo enumeran los elementos y atributos que se han agregado a hojas de entrada de servicios generadas automáticamente.

Tabla 9: Elementos existentes agregados a la hoja de entrada de servicios

Elemento Descripción

PaymentTerm Describe las condiciones de pago neto, el descuento o la condi­ción de penalización en una factura.

Tax Impuestos agregados a descuentos y cargos.

ShipNoticeIDInfo Especifica ID de referencia adicionales para ID relacionados con expedición

TotalCharges Total de todos los cargos aplicados a los bienes y servicios.

TotalAllowances Total de todos los descuentos aplicados a los bienes y servi­cios.

TotalAmountWithoutTax Suma el importe global de la factura sin impuestos.

NetAmount Total GrossAmount menos descuentos.

DepositAmount Depósito o importe de prepago total.

DueAmount Importe adeudado total.

SpecialHandlingAmount Cargo por manipulación especial total.

ShippingAmount Cargo de expedición total.

GrossAmount Importe bruto de pago de nivel de detalle

PriceBasisQuantity La cantidad para la que se ha ofertado un precio.

Tabla 10: Nuevos elementos creados para la hoja de entrada de servicios

Elemento Descripción

ServiceEntryDetailDiscount Asignado a InvoiceDetailDiscount

256PUBLICPÚBLICO

Guía de soluciones cXMLHojas de entrada de servicios

Page 257: 355a de soluciones cXML - help.sap.com

Elemento Descripción

ServiceEntryItemModifications Asignado a InvoiceItemModifications

ServiceEntryLaborDetail Asignado a InvoiceLaborDetail

ServiceEntryDetailShipping Asignado a InvoiceDetailShipping

ServiceEntryHeaderModifications Asignado a InvoiceHeaderModifications

ServiceEntryDetailSummaryIndustry Asignado a InvoiceDetailSummaryIndustry

ServiceEntryTimeCardDetail Asignado a InvoiceTimeCardDetail

ServiceEntryDetailSummaryRetail Asignado a InvoiceDetailSummaryRetail

ServiceEntryDetailLineIndicator Asignado a InvoiceDetailLineIndicator

Tabla 11: Nuevos atributos agregados a ServiceEntryItem

Atributo Descripción

referenceDate La fecha de referencia para el pedido global o artículo de con­trato. El uso de este atributo es opcional en la mayoría de los casos y debe ser definido por los socios comerciales implica­dos en la transacción. El software de gestión de compras puede utilizar esta fecha para la reconciliación de una factura contra un contrato o pedido global.

inspectionDate La fecha en la que tiene lugar la transferencia de bienes o la en­trega de servicios de acuerdo con las definiciones de impues­tos legales. El uso de este atributo es opcional en la mayoría de los casos y debe ser definido por los socios comerciales impli­cados en la transacción.

Hojas de entrada de servicios y pedidos de cancelación y cambio

Si hay pedidos de compra marcados como Servido parcialmente, en determinadas circunstancias Ariba Network acepta pedidos de cambio para ellos.

Los cambios permitidos para pedidos de compra dependen del estado de esos pedidos:

Estado del pedido de com­pra Cambios permitidos

Nuevo Los compradores pueden efectuar cualquier actualización excepto cambiar una línea de servicio (requiresServiceEntry="yes") por una línea de no servicio o viceversa. Las líneas de servicio deben continuar siendo líneas de servicio y las líneas de no servicio, líneas de no servicio en cualquier cambio que se efectúe en pedidos existentes.

Guía de soluciones cXMLHojas de entrada de servicios

PUBLICPÚBLICO 257

Page 258: 355a de soluciones cXML - help.sap.com

Estado del pedido de com­pra Cambios permitidos

Servido parcialmente ● Los compradores no pueden cambiar líneas de servicio a líneas de no servicio o viceversa en ningún momento.

● Los compradores pueden agregar tanto líneas de servicio como líneas de bienes materiales.● Los compradores pueden editar o suprimir tanto líneas de servicio como líneas de bienes

materiales contra las que se han creado hojas de entrada de servicios, se hayan aprobado o no.

Ejemplo ServiceEntryRequest

A modo de referencia se proporciona un ejemplo completo de una ServiceEntryRequest.

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cXML.org/schemas/cXML/1.2.025/Fulfill.dtd"><cXML payloadID="[email protected]"xml:lang="en-CA" timestamp="2001-10-14T08:39:29-08:00"> <Header> <From> <Credential domain="DUNS"> <Identity>123456789</Identity> </Credential> </From> <To> <Credential domain="NetworkID"> <Identity>AN01000002792</Identity> </Credential> </To> <Sender> <Credential domain="DUNS"> <Identity>123456789</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Ecommerce Supplier</UserAgent> </Sender> </Header> <Request> <ServiceEntryRequest> <ServiceEntryRequestHeader serviceEntryDate=”2013-08-12T21:03:20-07:00” serviceEntryID=”SES-10001” <PartnerContact> <Contact role=”from”> <Name xml:lang="en-US">ABC Construction</Name> <PostalAddress> <Street>125 Supplier Company Street</Street> <City>Sunnyvale</City> <State>CA</State> <PostalCode>94086</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> <Phone> <TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode>800</AreaOrCityCode> <Number>5555555</Number> </TelephoneNumber> </Phone> </Contact> </PartnerContact>

258PUBLICPÚBLICO

Guía de soluciones cXMLHojas de entrada de servicios

Page 259: 355a de soluciones cXML - help.sap.com

<PartnerContact> <Contact role=”to”> <Name xml:lang="en-US">XYZ Incorporated</Name> <PostalAddress> <Street>865 Buyer Company Street</Street> <Street>Suite 234</Street> <City>San Francisco</City> <State>CA</State> <PostalCode>94114</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> <Phone> <TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode>800</AreaOrCityCode> <Number>5555555</Number> </TelephoneNumber> </Phone> </Contact> </PartnerContact> <PartnerContact> <Contact role=”fieldEngineer”> Name xml:lang=”en-US”>Earl</Name> <Email>[email protected]</Email> </Contact> </PartnerContact> <PartnerContact> <Contact role=”fieldContractor”> <Name xml:lang=”en-US”>Conrad</Name> <Email>[email protected]</Email> </Contact> </PartnerContact> <PartnerContact> <Contact role=”requester”> <Name xml:lang=”en-US”>Bob</Name> <Email>[email protected]</Email> </Contact> </PartnerContact> <Period endDate=”20013-08-09T00:00:00-07:00” startDate=”2013-08-05T00:00:00-7:00></Period> </ServiceEntryRequestHeader> <ServiceEntryOrder> <ServiceEntryOrderInfo> <OrderReference orderID=”PO-HousingConstruction12345”> <DocumentReference payloadID="ServiceOrderPayloadID12345"> </DocumentReference> </OrderReference> </ServiceEntryOrderInfo> <ServiceEntryItem quantity="1" serviceLineNumber="1" type="service"> <ItemReference lineNumber="1"> <ItemID> <SupplierPartID>LW001-1</SupplierPartID> </ItemID> <Description xml:lang="en-US">Mobilization and Establish site</Description> </ItemReference> <SubtotalAmount> <Money currency="USD">10000.00</Money> </SubtotalAmount> </ServiceEntryItem> <ServiceEntryItem quantity="100" serviceLineNumber="2" type="service"> <ItemReference lineNumber="1"> <ItemID> <SupplierPartID>Crane1</SupplierPartID> </ItemID> <Description xml:lang="en-US">Service crane</Description>

Guía de soluciones cXMLHojas de entrada de servicios

PUBLICPÚBLICO 259

Page 260: 355a de soluciones cXML - help.sap.com

</ItemReference> <UnitOfMeasure>HUR</UnitOfMeasure> <UnitPrice> <Money currency="USD">500.00</Money> </UnitPrice> <SubtotalAmount> <Money currency="USD">50000.00</Money> </SubtotalAmount> </ServiceEntryItem> <ServiceEntryItem quantity="1000" serviceLineNumber="3" type="material"> <ItemReference lineNumber="1"> <ItemID> <SupplierPartID>SafetyFence</SupplierPartID> </ItemID> <Description xml:lang="en-US">Safety Fence</Description> </ItemReference> <UnitOfMeasure>FT</UnitOfMeasure> <UnitPrice> <Money currency="USD">1.00</Money> </UnitPrice> <SubtotalAmount> <Money currency="USD">1000.00</Money> </SubtotalAmount> </ServiceEntryItem> <ServiceEntryItem quantity="1" serviceLineNumber="4" type="service"> <ItemReference lineNumber="2"> <ItemID> <SupplierPartID>LW001-1</SupplierPartID> </ItemID> <Description xml:lang="en-US">Mobilization and Establish site</Description> </ItemReference> <UnitOfMeasure>EA</UnitOfMeasure> <UnitPrice> <Money currency="USD">10000.00</Money> </UnitPrice> <SubtotalAmount> <Money currency="USD">10000.00</Money> </SubtotalAmount> </ServiceEntryItem> </ServiceEntryOrder> <ServiceEntrySummary> <SubtotalAmount> <Money currency="USD">71000.00</Money> </SubtotalAmount> </ServiceEntrySummary> </ServiceEntryRequest> </Request> </cXML>

Actualizaciones de estado de ServiceEntryRequestLas organizaciones compradoras envían documentos StatusUpdateRequest para fijar el estado de las hojas de entrada de servicios en approved o rejected. Los proveedores habilitados para cXML pueden recibir estos documentos.

260PUBLICPÚBLICO

Guía de soluciones cXMLHojas de entrada de servicios

Page 261: 355a de soluciones cXML - help.sap.com

La siguiente tabla describe las opciones del estado de ServiceEntryRequest:

Estado Descripción

approved El sistema ERP del comprador ha aprobado la hoja de entrada de servicios.

rejected El sistema ERP del comprador ha rechazado la hoja de entrada de servicios debido a errores de vali­dación o de otro tipo o debido a que el usuario denegó la hoja de entrada de servicios en el flujo de aprobación.

Ariba Network publica estos documentos en la URL que los proveedores devuelven a su cXML ProfileResponse. Los proveedores no pueden cancelar hojas de entrada de servicios en ningún momento y no pueden facturar contra hojas de entrada de servicios rechazadas. Pueden editar y reenviar hojas de entrada de servicios rechazadas.

Los documentos StatusUpdateRequest identifican hojas de entrada de servicios mediante el elemento DocumentReference con documentType="ServiceEntryRequest" para el elemento DocumentInfo.

Ejemplo

<StatusUpdateRequest> <DocumentReference payloadID="ServiceOrderPayloadID12345"> </DocumentReference> <Status code="200" text="OK"></Status> <DocumentStatus type="approved"> <DocumentInfo documentID="SES-HC-t1" documentType="ServiceEntryRequest" documentDate="2013-08-12T21:03:20-07:00"> </DocumentInfo> <Comments>This service sheet has been approved.</Comments> </DocumentStatus> </StatusUpdateRequest>

Guía de soluciones cXMLHojas de entrada de servicios

PUBLICPÚBLICO 261

Page 262: 355a de soluciones cXML - help.sap.com

Solicitudes de oferta

Los compradores envían solicitudes de oferta a SAP Ariba Sourcing desde los sistemas ERP o desde la solución de facturación o compras proporcionada por SAP Ariba. El proceso de envío y procesamiento de estas solicitudes de oferta varía en función del sistema en el que se ha originado. Los compradores pueden generar RFQ en los sistemas ERP y enviar una solicitud de oferta a SAP Ariba Sourcing que se utiliza para un evento de sourcing. Las solicitudes de oferta también se pueden utilizar con la función de automatización de oferta para procesar y publicar las RFQ en SAP Ariba Discovery.

Integración SAP Ariba Sourcing con SAP ERP [página 262]

Automatización de ofertas [página 272]

Integración de sourcing con Soluciones de SAP Ariba Procurement [página 279]

Integración SAP Ariba Sourcing con SAP ERPVarios elementos extrínsecos de cXML admiten campos que se envían del componente central SAP ERP (ECC) a SAP Ariba Sourcing. SAP envía un documento QuoteRequest a SAP Ariba Sourcing con información que SAP Ariba Sourcing utiliza para crear una solicitud de Sourcing. En la mayoría de los casos, la solicitud de Sourcing se utiliza para crear un evento de Sourcing que incluye datos y artículos de la solicitud de Sourcing. Una vez finalizado el evento, SAP Ariba Sourcing puede enviar información de adjudicación o de precios de vuelta a SAP en un documento QuoteMessage.

Documentos QuoteRequest para la integración SAP Ariba Sourcing [página 262]

Documentos QuoteMessage para la integración SAP Ariba Sourcing [página 267]

Documentos QuoteRequest para la integración SAP Ariba Sourcing

Se envía un documento quoterequest a SAP Ariba Sourcing; SAP Ariba Sourcing lo utiliza para crear una solicitud de sourcing.

Un documento quoteRequest contiene un elemento QuoteRequest. El siguiente ejemplo muestra la estructura básica de un elemento QuoteRequest:

<QuoteRequest> <QuoteRequestHeader> header information </QuoteRequestHeader> <QuoteItemOut> QuoteItemOut information </QuoteItemOut> </QuoteRequest>

262PUBLICPÚBLICO

Guía de soluciones cXMLSolicitudes de oferta

Page 263: 355a de soluciones cXML - help.sap.com

QuoteRequestHeader para la integración SAP Ariba Sourcing

QuoteRequestHeaderincluye información general sobre la solicitud de ofertas.

QuoteRequestHeader tiene los atributos siguientes:

Nombre de atributo Descripción

requestID Número interno único que especifica el ID del sistema del comprador para la solicitud de oferta.

Este campo es obligatorio.

requestDate La fecha y hora del documento QuoteRequest.

Este campo es obligatorio.

requestVersion El número de versión de la QuoteRequest en el sistema del comprador. Se puede aplicar cuando hay un cambio en la QuoteRequest original. El número de versión para el docu­mento QuoteRequest original debe ser 1 e irse incrementando de uno en uno para cada versión posterior.

Por ejemplo, la segunda versión de la QuoteRequest tiene que ser 2.

type El tipo de QuoteRequest, uno de:

● nuevo● actualizar● suprimir

El valor predeterminado es "nuevo".

currency La divisa en la cual se tiene que pujar la solicitud de oferta.

Este campo es obligatorio.

templateName La plantilla utilizada por la aplicación de sourcing. La plantilla puede destacar los términos y las condiciones respecto a los detalles para una solicitud de oferta enviada entre el compra­dor y la aplicación de sourcing.

openDate La fecha en la que quoteRequest está abierta para que los proveedores respondan.

closeDate La fecha en la que quoteRequest se cierra para las respuestas de los proveedores.

previewDate La fecha en la que quoteRequest está disponible para los proveedores.

El elemento QuoteRequestHeader tiene los siguientes elementos:

Nombre de elemento Descripción

Name El nombre de la QuoteRequest. Este campo es opcional.

MasterAgreementIDinfo El número de ID del comprador para el correspondiente acuerdo maestro del contrato o el pedido preferente. Este campo es opcional.

Guía de soluciones cXMLSolicitudes de oferta

PUBLICPÚBLICO 263

Page 264: 355a de soluciones cXML - help.sap.com

Nombre de elemento Descripción

SupplierSelector Define los criterios de selección del proveedor para una QuoteRequest. Este campo es op­cional.

El elemento SupplierSelector tiene el elemento SupplierID con el siguiente atributo obliga­torio:

● MatchingType: Especifica cómo los proveedores coinciden para una QuoteRequest.El atributo SupplierSelector puede tener los valores siguientes:

● InvitationOnly: Los proveedores coinciden con los proveedores que han sido invitados a unirse a la red.

● approvedVendorOnly: Proveedores de la lista maestra de suministradores. Sin em­bargo, la aplicación de sourcing puede filtrar los proveedores que pueden pujar en fun­ción de la categoría del producto o del servicio y las reglas de coincidencia del territo­rio.

● public: Cualquier proveedor público. El proveedor también puede existir en la lista maestra de suministradores.

El SupplierSelector puede contener elementos SupplierInvitation, en los que cada elemento SupplierInvitation especifica un proveedor (participante) invi­tado al evento. Cada elemento SupplierInvitation contiene los siguientes elemen­tos secundarios:

● OrganizationID● Correspondent● MasterAgreementIDInfo● Extrinsic

Para obtener más información, consulte la sección Solicitud de oferta > QuoteRequestHea­der> SupplierSelector en la Guía de referencia de cXML.

Total El importe total de QuoteRequest. Este campo es opcional.

Description Descripción de la QuoteRequest. Este campo es opcional.

ShipTo La información de Expedir a para la QuoteRequest. Este campo es opcional.

Contact La información de contacto para la solicitud. Puede haber más de un elemento de contacto. Este campo es opcional.

Extrinsic Datos extraños específicos de la solicitud. Puede que haya más de un elemento extrínseco, pero siempre hay un extrínseco Terms.

QuoteItemOut para la integración SAP Ariba Sourcing

Cada QuoteItemOut en los detalles de tienda de una QuoteRequest sobre un artículo en línea.

QuoteItemOut tiene atributos, elementos y un extrínseco Terms.

264PUBLICPÚBLICO

Guía de soluciones cXMLSolicitudes de oferta

Page 265: 355a de soluciones cXML - help.sap.com

El elemento QuoteItemOut tiene los siguientes atributos:

Atributo Descripción

quantity(obligatorio)

El número de artículos.

Si el tipo de pedido es “global” y tiene artículos a nivel de proveedor y de mercancía, el valor predeterminado es 1. No se tiene en cuenta esta cantidad para calcular el subtotal. En lugar de esto, el MaxAmount en BlanketItemDetail se utiliza para indicar cual­quier importe a nivel de línea.

lineNumber Posición de línea (contando desde 1) del artículo en una QuoteRequest. Se utiliza para actualizar una referencia entre los artículos del documento con el tipo como "new" y "update".

parentLineNumber Posición (contando desde 1) de este elemento superior del artículo en una QuoteRequest. Se utiliza para actualizar una referencia jerárquica entre los artículos de los documentos.

requestedDeliveryDate La fecha de entrega solicitada para el artículo en línea.

itemClassification Especifica si el artículo en línea actual es "material" o "service".

itemType Especifica el tipo de artículo. Valores posibles:

● composite: Identifica un grupo de artículos.● item: Identifica un artículo en línea independiente.● lean: Indica que no hay ningún artículo inferior para la línea.

serviceLineType Representa el tipo de línea de servicio. Valores posibles:

● standard: Servicio estándar.● blanket: Servicio global para el que no especifica ninguna cantidad. Se calcula

como una suma global.● contingency: Servicio que no es absolutamente necesario para llevar a cabo el

pedido.● openquantity: Servicio para el cual el solicitante requiere que el licitador ofrezca

la cantidad para un servicio parcial determinado.● information: El tipo de línea no describe ningún servicio y solo tiene fines infor­

mativos.

QuoteItemOut tiene los siguientes elementos:

Elemento Descripción

ItemID Proporciona una identificación única de un artículo.

ItemDetail(obligatorio)

Contiene información descriptiva sobre el artículo que las aplicaciones de compras pre­sentan a los usuarios.

ShipTo La dirección de expedición para un artículo. ShipTo contiene cuatro elementos: Address, CarrierIdentifier, TransportInformation y IdReference.

Shipping Contiene información adicional para el transporte del envío.

Tax Contiene información fiscal.

SpendDetail Captura la información de los gastos.

Guía de soluciones cXMLSolicitudes de oferta

PUBLICPÚBLICO 265

Page 266: 355a de soluciones cXML - help.sap.com

Elemento Descripción

Total Contiene el coste total de los artículos del pedido, sin impuestos ni expedición.

TermsOfDelivery Especifica las condiciones de entrega para el aviso de expedición.

ReferenceDocumentInfo Contiene información sobre un documento de referencia.

Contact La información de contacto para el proveedor. Puede especificar más de un elemento Contact.

Comments Contiene comentarios asociados con este artículo en línea de RFQ. El elemento Comments puede contener un elemento Attachment para incluir archivos externos.

Alternative Representa una opción alternativa a las líneas de especificación de servicio.

SupplierSelector Define cómo se seleccionan los proveedores para responder a una RFQ. Si está presente, contiene un elemento SupplierInvitation para cada proveedor invitado a enviar una respuesta para el artículo. Si está ausente o no contiene elementos SupplierInvitation, todos los proveedores invitados al evento pueden enviar una respuesta para el artículo.

Jerarquía de servicios y artículos de servicio de SAP (versión 1.2.034 o posterior del adaptador cXML)

Un documento quoteRequest o quoteMessage puede contener datos para artículos de servicio de SAP (artículos de la categoría de artículo de SAP D) en la jerarquía de servicio.

Los documentos quoteRequest recibidos de SAP y los documentos quoteMessage enviados a SAP tienen los siguientes artículos en los elementos QuoteItemOut y QuoteItemIn para las jerarquías de servicios:

● El atributo itemClassification con el valor service.● El atributo itemType fijado en composite para líneas de servicio y esquemas de servicio, o fijado en item

para especificaciones de servicio.● Los atributos parentLineNumber y lineNumber se utilizan para enlazar artículos primarios y secundarios,

como una línea de servicio primaria y una especificación de servicio secundaria. El valor de un atributo parentLineNumber secundario coincide con su atributo lineNumber primario.

● El elemento secundario Classification tiene el atributo code fijado en Services y el atributo domain fijado en MaterialGroup. El valor del elemento Classification es un grupo de materiales de SAP.

A continuación, un extracto de un documento quoteRequest con 3 elementos QuoteItemOut: una línea de servicio, un esquema de servicio y una especificación de servicio.

<QuoteItemOut itemClassification="service" itemType="composite" quantity="1.000" requestedDeliveryDate="2017-08-28T07:45:50+05:30" lineNumber="00010"> <ItemDetail> <UnitPrice> <Money currency="USD"/> </UnitPrice> <Description xml:lang="en">Services</Description> <UnitOfMeasure>SU</UnitOfMeasure> <Classification code="Services" domain="MaterialGroup">007</Classification> </ItemDetail> <ReferenceDocumentInfo lineNumber="00010"> <DocumentInfo documentType="Requisition" documentID="0010021706">Constant</DocumentInfo>

266PUBLICPÚBLICO

Guía de soluciones cXMLSolicitudes de oferta

Page 267: 355a de soluciones cXML - help.sap.com

</ReferenceDocumentInfo> <Comments xml:lang="en">true </Comments></QuoteItemOut> <QuoteItemOut itemType="composite" quantity="0.000" parentLineNumber="00010" lineNumber="0000200010"> <ItemDetail> <UnitPrice> <Money currency="USD"/> </UnitPrice> <Description xml:lang="en">Set up Construction site</Description> <UnitOfMeasure/> <Classification domain="MaterialGroup"/> </ItemDetail> <ReferenceDocumentInfo lineNumber="00010"> <DocumentInfo documentType="RFQ" documentID="6000001310"/> </ReferenceDocumentInfo></QuoteItemOut> <QuoteItemOut itemType="item" quantity="1.000" parentLineNumber="0000200010" serviceLineType="standard" lineNumber="1000300010"> <ItemID> <SupplierPartID/> <BuyerPartID>000000000000100000</BuyerPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD"/> </UnitPrice> <Description xml:lang="en">Set up construction site</Description> <UnitOfMeasure>SU</UnitOfMeasure> <Classification domain="MaterialGroup">007</Classification> </ItemDetail> <ReferenceDocumentInfo lineNumber="0000300010"> <DocumentInfo documentType="RFQ" documentID="6000001310"/> </ReferenceDocumentInfo> </QuoteItemOut>

Documentos QuoteMessage para la integración SAP Ariba Sourcing

SAP Ariba Sourcing envía documentos quoteMessage con información sobre determinación de precios o adjudicación de un evento.

Un quoteMessage contiene un elemento QuoteMessage. El elemento QuoteMessage tiene los siguientes elementos:

● QuoteMessageHeader● QuoteItemIn

QuoteMessageHeader para SAP Ariba Sourcing

El elemento QuoteMessageHeader ofrece información general sobre QuoteMessage.

El documento cXML QuoteMessage que describe un documento de adjudicación recibido en respuesta a una RFQ de SAP tiene que incluir el atributo Currency en el elemento QuoteMessageHeader. El atributo Currency define

Guía de soluciones cXMLSolicitudes de oferta

PUBLICPÚBLICO 267

Page 268: 355a de soluciones cXML - help.sap.com

la divisa utilizada en el proyecto de Sourcing. La Currency se puede definir utilizando códigos de divisas ISO o no ISO.

QuoteMessageHeader tiene los siguientes atributos adicionales:

Nombre de atributo Descripción

Type La acción del proveedor en la QuoteRequest. Puede tener uno de los siguientes valores:

● accept● reject● update● final● award

Este campo es obligatorio.

quoteID ID único de la oferta.

Este campo es obligatorio.

quoteDate Fecha en la cual se ha enviado la oferta.

Este campo es obligatorio.

La cabecera QuoteMessageHeader tiene los siguientes elementos:

Nombre de elemento Descripción

SupplierID La identificación unívoca del proveedor. Puede haber más de un SupplierID. Este campo es obligatorio.

Total El importe total de QuoteRequest.

ShipTo La dirección ShipTo de la QuoteRequest.

Contact La información de contacto para QuoteRequest.

QuoteRequestReference Contiene el RequestID y la requestDate.

QuoteRequestReference tiene los atributos siguientes:

● requestID: Número interno único que especifica el ID del sistema del comprador para la solicitud de oferta. Este atributo es obligatorio.

● requestDate: La fecha y hora del documento QuoteRequest.QuoteRequestReference tiene el siguiente elemento:

● DocumentReference: indica cuándo un tipo de documento se actualiza o se su­prime. Se refiere al documento quoteRequest más reciente.

Comments Contiene comentarios acerca de la solicitud. Este campo es opcional.

Extrinsic Contiene información del extrínseco. Puede que haya más de un elemento Extrinsic, pero siempre hay un extrínseco Terms.

268PUBLICPÚBLICO

Guía de soluciones cXMLSolicitudes de oferta

Page 269: 355a de soluciones cXML - help.sap.com

Respuestas de participante a preguntas del evento

Las respuestas de los participantes a las preguntas del evento se incluyen en el extrínseco Terms dentro de QuoteMessageHeader. La respuesta está vinculada a su pregunta correspondiente por su atributo name, que se establece en el valor del campo Asignación de campos ERP para la pregunta.

SAP Ariba Sourcing puede enviar los siguientes tipos de respuestas de preguntas en los datos de adjudicación:

● Adjunto. El archivo adjunto se envía como parte de un sobre de las Extensiones de correo de Internet multipropósito (MIME) con el documento QuoteMessage. El extrínseco para la respuesta tiene un elemento Attachment secundario, que contiene un elemento URL secundario con un ID de contenido (Content-ID o CID) para el adjunto. El adjunto correspondiente contiene el mismo CID en su encabezado.Por ejemplo, un QuoteMessageHeader contiene los siguientes elementos:

<Extrinsic name="Terms"> <Extrinsic name="SupplierDesignSpecifications"> <Attachment> <URL>cid:0</URL>

El ID de contenido para el archivo adjunto es 0; el encabezado MIME para el archivo adjunto correspondiente contiene la siguiente entrada:Content-ID<0>Para obtener más información acerca de los adjuntos en documentos cXML, consulte la Guía de referencias cXML. http://www.cxml.org .

RestricciónSAP Ariba Cloud Integration Gateway no admite respuestas con tipo Adjunto.

● Fecha. SAP Ariba Sourcing envía la respuesta en uno de los siguientes formatos:AAAA-MM-DDThh:mm:ss+hh:mmAAAA-MM-DDThh:mm:ss-hh:mmDonde:○ AAAA indica el año○ MM indica el mes○ DD Indica el día○ T es un valor literal que especifica el inicio de la sección de tiempo○ hh indica la hora○ mm indica los minutos○ ss indica los segundos○ +hh:mm especifica una zona horaria con un desplazamiento positivo de UTC (hora universal coordinada)○ -hh:mm especifica una zona horaria con un desplazamiento negativo de UTC (hora universal coordinada)

Por ejemplo:2019-05-25T00:00:00-08:00El formato de fecha es un subconjunto restringido de ISO 8601. El designador de zona horaria "Z" no está permitido.

● Número decimal● Dinero SAP Ariba Sourcing envía la respuesta en el siguiente formato:

amountcurrencyIDDonde amount es una cantidad numérica y currencyID es el ID para el tipo de moneda. Por ejemplo, 100 USD.

Guía de soluciones cXMLSolicitudes de oferta

PUBLICPÚBLICO 269

Page 270: 355a de soluciones cXML - help.sap.com

● Porcentaje: La respuesta se envía solo con el valor numérico (sin signo de porcentaje). Por ejemplo, 99.● Cantidad● Texto (limitado una sola línea)● Texto (una sola línea)● Texto (varias líneas)● Número entero● Sí/No (booleano). La respuesta se envía como Yes o No.

QuoteItemIn para la integración SAP Ariba Sourcing

QuoteItemIn describe la acción del proveedor en un artículo en línea en el QuoteMessage. Un QuoteMessage puede contener múltiples definiciones de QuoteItemIn.

El elemento QuoteItemIn tiene atributos, elementos y un extrínseco Terms.

El elemento QuoteItemIn tiene los siguientes atributos:

Nombre de atributo Descripción

Type La acción del proveedor en la QuoteRequest. Puede tener uno de los siguientes valores:

● accept● reject● update● final● award

Este campo es obligatorio.

Quantity El número de artículos.

Si el tipo de pedido es “global” y tiene artículos a nivel de proveedor y de mercancía, el valor predeterminado es “1”. No se tiene en cuenta esta cantidad para calcular el subtotal. En lu­gar de esto, el MaxAmount en BlanketItemDetail se utiliza para indicar cualquier importe a nivel de línea.

Este campo es obligatorio.

lineNumber Posición de línea del artículo en la QuoteRequest. Utilizado para actualizar una referencia entre los artículos en el documento con el tipo como “nuevo” y “actualizar”.

Este campo es opcional.

requestedDeliveryDate La fecha de entrega solicitada para el artículo en línea.

Este campo es opcional.

rank La posición de la puja.

Un QuoteItemIn tiene los siguientes elementos:

● ItemID● ItemDetail● ShipTo

270PUBLICPÚBLICO

Guía de soluciones cXMLSolicitudes de oferta

Page 271: 355a de soluciones cXML - help.sap.com

● Shipping● Tax● SpendDetail● Contact● Comments

Adjuntos de artículo de línea en datos de adjudicación

SAP Ariba Sourcing incluye los adjuntos que los proveedores han agregado a los artículos en línea en los documentos QuoteMessage utilizando Multipurpose Internet Mail Extensions (MIME).

Un artículo en línea está vinculado a su adjunto mediante un ID de contenido (Content-ID o CID). Si un artículo en línea tiene un adjunto, el elemento QuoteItemIn para el artículo en línea en el QuoteMessage incluye los siguientes elementos:

<Comments> <Attachment> <URL>cid:contentID</URL>

El contentID corresponde al Content-ID en la cabecera MIME del adjunto.

Por ejemplo, un QuoteItemIn contiene los siguientes elementos:

<Comments> <Attachment> <URL>cid:0</URL>

El ID de contenido para este artículo en línea es 0; la cabecera MIME para el adjunto correspondiente contiene la siguiente entrada:

Content-ID<0>

QuoteMessage con condiciones de determinación de precios

Un documento cXML QuoteMessage puede contener condiciones de determinación de precios para los artículos en línea. Las condiciones de determinación de precios se pueden definir dentro de un elemento intrínseco o un elemento extrínseco en el documento cXML QuoteMessage.

Puede integrar un documento cXML QuoteMessage que contiene condiciones de determinación de precios como un acuerdo marco (contrato) entre SAP Ariba Sourcing y SAP ERP a través de SAP Ariba Cloud Integration Gateway mediante el elemento intrínseco PricingConditions o el elemento extrínseco AdvancedPriceConditions.

Para obtener más información, consulte la sección Acerca de las condiciones de determinación de precios en SAP RFQ y la integración de la adjudicación con SAP Ariba Sourcing en la guía RFQ e integración de adjudicación con SAP Ariba Sourcing.

Guía de soluciones cXMLSolicitudes de oferta

PUBLICPÚBLICO 271

Page 272: 355a de soluciones cXML - help.sap.com

Automatización de ofertasLos compradores envían los documentos QuoteRequest de su sistema ERP a SAP Ariba Discovery mediante Ariba Network. Ariba Network determina si el proveedor especificado en el documento QuoteRequest es un proveedor registrado en Ariba Network.

Si no lo es, Ariba Network crea una nueva cuenta de proveedor y envía el documento QuoteRequest a SAP Ariba Discovery para crear una comunicación de RFQ. La información de proveedor también se envía a SAP Ariba Discovery.

SAP Ariba Discoveryagrupa proveedores en función de las mercancías y los territorios de venta especificados en el documento QuoteRequest y los proveedores son invitados a participar y responder a la comunicación de RFQ. Si el proveedor no está registrado, SAP Ariba Discovery envía una invitación al proveedor solicitándole que se registre y participe en la comunicación de RFQ.

SAP Ariba Discovery envía después todas las pujas, las líderes o las ganadoras en función del valor especificado en el documento QuoteRequest al sistema ERP del comprador.

Documento QuoteRequest [página 272]

Documento QuoteRequest de ejemplo [página 275]

Cancelación de solicitudes de oferta [página 278]

Información relacionada

Utilización de solicitudes de oferta [página 69]

Documento QuoteRequest

El documento QuoteRequest contiene el elemento QuoteRequest.

El elemento QuoteRequest tiene los siguientes elementos:

● QuoteRequestHeader● QuoteItemOut

El QuoteRequestHeader tiene los siguientes elementos opcionales:

● Name● SupplierSelector● Total● Description● ShipTo● Contact● Comments● QuoteHeaderInfo

272PUBLICPÚBLICO

Guía de soluciones cXMLSolicitudes de oferta

Page 273: 355a de soluciones cXML - help.sap.com

● Extrinsic

Elemento SupplierSelector

El elemento opcional SupplierSelector especifica cómo SAP Ariba Discovery selecciona y empareja proveedores.

Este elemento tiene el atributo siguiente:

MatchingType: SAP Ariba Discovery utiliza este valor de atributo para determinar cómo deben emparejarse los proveedores e invitarles a participar en la comunicación de RFQ en SAP Ariba Discovery. Este es un campo obligatorio.

El atributo MatchingType puede tener los siguientes valores:

● InvitationOnly: Los proveedores que han sido invitados a participar en la comunicación de RFQ se especifican en el elemento OrganizationID.

● approvedVendorOnly: Proveedores que existen en Ariba Network. El proveedor debería ser un proveedor aprobado con el comprador. Sin embargo, SAP Ariba Discovery puede filtrar los proveedores que pueden pujar en función de las reglas de coincidencia de mercancía y territorio.

● public: Cualquier proveedor público. El proveedor debe existir en Ariba Network. Sin embargo, SAP Ariba Discovery puede filtrar los proveedores que pueden pujar en función de las reglas de coincidencia de mercancía y territorio.

El elemento SupplierSelector contiene un elemento SupplierInvitation para cada proveedor seleccionado. Cada elemento SupplierInvitation contiene los siguientes elementos secundarios:

● OrganizationID● Correspondent● MasterAgreementIDInfo● Extrinsic

SupplierInvitation

SAP Ariba Discovery utiliza el elemento SupplierInvitation para identificar el proveedor que ha sido invitado a unirse a la comunicación de RFQ.

El elemento SupplierInvitation tiene el atributo siguiente:

● supplierStatusEl atributo supplierStatus puede tener los siguientes valores:○ approved: El proveedor existe en el sistema del comprador y ha sido aprobado por el comprador. El valor

predeterminado es "aprobado".○ contracted: El proveedor es un proveedor aprobado en el sistema del comprador y tiene un acuerdo

maestro asociado de un contrato. El comprador puede especificar el MasterAgreementIDInfo.

Guía de soluciones cXMLSolicitudes de oferta

PUBLICPÚBLICO 273

Page 274: 355a de soluciones cXML - help.sap.com

OrganizationID

El elemento OrganizationID es una identificación unívoca del proveedor en Ariba Network. El comprador utiliza este elemento para especificar proveedores que han sido invitados a la puja.

Correspondent

El elemento opcional Correspondent almacena la información de contacto del proveedor y se utiliza para identificar al proveedor y para ponerse en contacto con él.

Si el proveedor no existe, Ariba Network utiliza la información de contacto para enviarle una invitación para que se registre en Ariba Network

MasterAgreementIDInfo

El elemento opcional MasterAgreementIDInfo es el número de ID del comprador para el correspondiente acuerdo maestro del contrato o el pedido preferente. Este elemento se completa con el elemento IdReference.

Extrinsic

El elemento opcional Extrinsic permite a los compradores proporcionar información adicional para la SupplierInvitation. Los compradores pueden especificar más de un elemento Extrinsic.

Extrínseco processingTarget

La automatización de ofertas le permite configurar el flujo de RFQ, tanto si desea que Ariba Network las enrute a SAP Ariba Discovery como a SAP Ariba Sourcing.

De manera predeterminada, la configuración de enrutamiento se fija en SAP Ariba Sourcing, lo que significa que Ariba Network enruta el flujo de eventos de RFQ a SAP Ariba Sourcing. Sin embargo, si la RFQ se origina del sistema SAP S/4HANA ERP, puede controlar el flujo de cada RFQ especificando el siguiente extrínseco en el documento quoteRequest:

processingTarget

El extrínseco especificado en la cabecera del documento cXML quoteRequest ignora la configuración de enrutamiento de RFQ fijada en Ariba Network para la automatización de ofertas. Puede especificar uno de los siguientes valores en el extrínseco processingTarget:

● QuoteAutomation● sourcingRequest

274PUBLICPÚBLICO

Guía de soluciones cXMLSolicitudes de oferta

Page 275: 355a de soluciones cXML - help.sap.com

Un ejemplo del fragmento de código que contiene el extrínseco:

<Extrinsic name="processingTarget">sourcingRequest</Extrinsic>

Si especifica el valor del extrínseco como QuoteAutomation, Ariba Network procesa el evento de RFQ y lo enruta a SAP Ariba Discovery independientemente de la configuración de enrutamiento fijada en Ariba Network.

Documento QuoteRequest de ejemploUn comprador envía un documento QuoteRequest al proveedor para invitarle a pujar. El siguiente ejemplo es una muestra del documento QuoteRequest:

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/schemas/cXML/1.2.025/Quote.dtd"><cXML payloadID="123" timestamp="2013-11-19T11:50:11+00:00" version="1.2.025"><Header> <From> <Credential domain="NetworkId"> Identity>AN02000533043</Identity> </Credential> </From> <To> <Credential domain="NetworkId"> <Identity>AN02000533043</Identity> </Credential> </To> <Sender> <Credential domain="NetworkID"> <Identity>AN02000533043</Identity> <SharedSecret>sharedsecret</SharedSecret> </Credential> <UserAgent>Procurement App 2.0</UserAgent> </Sender></Header><Request deploymentMode="production"> <QuoteRequest> <QuoteRequestHeader requestID="2021.2215" requestDate="2014-03-06T23:25:01.000-07:00" type="new" openDate="2014-03-10T23:13:49.000-07:00" currency="USD" xml:lang="en" closeDate="2014-03-17T00:00:00.000-07:00" quoteReceivingPreference="winningOnly"> <SupplierSelector matchingType="invitationOnly"> <SupplierInvitation> <OrganizationID> <Credential domain="VendorID"> <Identity>2210</Identity> </Credential> </OrganizationID> <Correspondent> <Contact> <Name xml:lang="en">New Inv Inc</Name> <PostalAddress> <DeliverTo>922 West</DeliverTo> <Street>15th Avenue</Street> <City>California</City> <State>CA</State> <PostalCode>93504</PostalCode> <Country isoCountryCode="US"></Country> </PostalAddress> <Email>[email protected]</Email> <Phone>

Guía de soluciones cXMLSolicitudes de oferta

PUBLICPÚBLICO 275

Page 276: 355a de soluciones cXML - help.sap.com

<TelephoneNumber> <CountryCode isoCountryCode="US"></CountryCode> <AreaOrCityCode>ca</AreaOrCityCode> <Number>2342344</Number> </TelephoneNumber> </Phone> <URL></URL> </Contact> </Correspondent> </SupplierInvitation> </SupplierSelector> <Description xml:lang="" >Quote for AS1</Description> <ShipTo> <Address isoCountryCode="US" addressID="409" > <Name xml:lang="en" >P2- Los Angeles</Name> <PostalAddress name="P2- Los Angeles" > <Street>1022 Sepulveda Blvd</Street> <Street>Suite 1000Address2</Street> <Street>Address3</Street> <City>El Segundo</City> <State>California</State> <PostalCode>90245</PostalCode> <Country isoCountryCode="US" >United States</Country> </PostalAddress> <Phone> <TelephoneNumber> <CountryCode isoCountryCode="US" /> <AreaOrCityCode/> <Number/> </TelephoneNumber> </Phone> <Fax> <TelephoneNumber> <CountryCode isoCountryCode="US" /> <AreaOrCityCode/> <Number/> </TelephoneNumber> </Fax> </Address> </ShipTo> </QuoteRequestHeader> . . .

Documento QuoteMessage

El documento QuoteMessage describe los artículos o servicios para los cuales el comprador solicita ofertas. El siguiente ejemplo es una muestra del documento QuoteMessage:

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.025/Quote.dtd"><cXML payloadID="[email protected]" timestamp="2013-08-11T08:50:12-07:00" version="1.2.025" xml:lang="en-US"> <Header> <From> <Credential domain="NetworkID"> <Identity>AN02000873997</Identity> </Credential> </From> <To> <Credential domain="NetworkID"> <Identity>AN70000000073</Identity>

276PUBLICPÚBLICO

Guía de soluciones cXMLSolicitudes de oferta

Page 277: 355a de soluciones cXML - help.sap.com

</Credential> </To> <Sender> <Credential domain="NetworkID"> <Identity>AN01000874827</Identity> <SharedSecret>sharedsecret</SharedSecret> </Credential> <UserAgent>Procurement App 2.0</UserAgent> </Sender> </Header> <Message> <QuoteMessage> <QuoteMessageHeader xml:lang="en" currency="USD" quoteDate="2013-10-03T08:24:15-07:00" quoteID="T123" type="award"> <OrganizationID> <Credential domain="NetworkID"> <Identity>AN02000873997</Identity> </Credential> </OrganizationID> <Total> <Money currency="USD">235400.0</Money> </Total> <QuoteRequestReference requestDate="2013-10-03T08:14:54-07:00" requestID="2021.2215"/> </QuoteMessageHeader> <QuoteItemIn rank="1" lineNumber="1" quantity="100" type="award"> <ItemID> <SupplierPartID>SupplierPartID-1</SupplierPartID> <SupplierPartAuxiliaryID>SupplierPartAuxID-1 </SupplierPartAuxiliaryID> <BuyerPartID/> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">950.00</Money> </UnitPrice> <Description xml:lang="en">Laptops</Description> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="unspsc">43211503</Classification> <ManufacturerPartID>ManufacturerPartID-1</ManufacturerPartID> <ManufacturerName>ManufacturerName-1</ManufacturerName> <URL>http://www.abc.com-1</URL> <LeadTime>31</LeadTime> </ItemDetail> <Shipping> <Money currency="USD">100.0000000000</Money> <Description xml:lang="en">Maximum shipping allowance-1</Description> </Shipping> <Tax> <Money currency="USD">100.0000000000</Money> <Description xml:lang="en">Maximum tax allowance-1</Description> </Tax> <Total> <Money currency="USD">95200.00</Money> </Total> </QuoteItemIn> <QuoteItemIn rank="1" lineNumber="2" quantity="200" type="award"> <ItemID> <SupplierPartID>SupplierPartID-2</SupplierPartID> <SupplierPartAuxiliaryID>SupplierPartAuxID-2 </SupplierPartAuxiliaryID> <BuyerPartID/> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">700.00</Money>

Guía de soluciones cXMLSolicitudes de oferta

PUBLICPÚBLICO 277

Page 278: 355a de soluciones cXML - help.sap.com

</UnitPrice> <Description xml:lang="en">Desktop Computers</Description> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="unspsc">43211507</Classification> <ManufacturerPartID>ManufacturerPartID-2</ManufacturerPartID> <ManufacturerName>ManufacturerName-2</ManufacturerName> <URL>http://www.abc.com-2</URL> <LeadTime>32</LeadTime> </ItemDetail> <Shipping> <Money currency="USD">100.0000000000</Money> <Description xml:lang="en">Maximum shipping allowance-2</Description> </Shipping> <Tax> <Money currency="USD">100.0000000000</Money> <Description xml:lang="en">Maximum tax allowance-2</Description> </Tax> <Total> <Money currency="USD">140200.00</Money> </Total> </QuoteItemIn> </QuoteMessage> </Message>

Cancelación de solicitudes de ofertaLas organizaciones compradores pueden cancelar una solicitud de oferta enviada a la aplicación de sourcing. Ariba Network muestra el estado de las solicitudes de oferta canceladas como “Obsoleto.”

Las solicitudes de oferta canceladas son las mismas que las solicitudes de oferta regulares, salvo que el elemento QuoteRequestHeader tiene el atributo type="delete" en lugar de "new" y del atributo requestID de la solicitud de oferta original.

El siguiente ejemplo muestra cómo cancelar una solicitud de oferta:

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/schemas/cXML/1.2.029/Quote.dtd"><cXML payloadID="123" timestamp="2016-02-02T11:50:11+00:00" version="1.2.029"> <Header> <From> <Credential domain="NetworkId"> Identity>AN02000533043</Identity> </Credential> </From> <To> <Credential domain="NetworkId"> <Identity>AN02000533043</Identity> </Credential> </To> <Sender> <Credential domain="NetworkID"> <Identity>AN02000533043</Identity> <SharedSecret>sharedsecret</SharedSecret> </Credential> <UserAgent>Procurement App 2.0</UserAgent> </Sender> </Header> <Request deploymentMode="production"> <QuoteRequest> <QuoteRequestHeader requestID="6000000131"

278PUBLICPÚBLICO

Guía de soluciones cXMLSolicitudes de oferta

Page 279: 355a de soluciones cXML - help.sap.com

requestDate="2016-02-02T13:56:00-5:00" type="delete" openDate="2016-02-02T13:56:00-5:00" closeDate="2016-03-02T13:56:00-5:00" currency="USD" xml:lang="en" quoteReceivingPreference="winningOnly"> ... </QuoteRequestHeader> </QuoteRequest> </Request> </cXML>

Integración de sourcing con Soluciones de SAP Ariba ProcurementCuando Soluciones de SAP Ariba Procurement se integran con SAP Ariba Sourcing, una solución de compras puede enviar un documento QuoteRequest a SAP Ariba Sourcing, que SAP Ariba Sourcing utiliza para crear una solicitud de sourcing.

Por defecto, Soluciones de SAP Ariba Procurement puede enviar solicitudes de sourcing solo para las solicitudes de compra agregadas, pero si el parámetro de configuración del sitio Application.Purchasing.EnableQuickSourcingForRequisition se establece en Yes, Soluciones de SAP Ariba Procurement también puede enviar solicitudes de sourcing para solicitudes de compra normales.

El documento QuoteRequest se envía directamente de Soluciones de SAP Ariba Procurement a SAP Ariba Sourcing. Un agente de sourcing crea un proyecto de sourcing para la solicitud de sourcing en SAP Ariba Sourcing e invita a los proveedores a participar en el evento de sourcing. Cuando los proveedores hayan enviado sus pujas, el agente de sourcing concede la puja a los proveedores más adecuados, genera las condiciones de determinación de precios y las envía a Soluciones de SAP Ariba Procurement, donde se aplican en la solicitud. Las condiciones de determinación de precios se envían mediante QuoteDataMessage.

Documentos QuoteRequest enviados por Soluciones de SAP Ariba Procurement [página 279]

Documentos QuoteMessage enviados a Soluciones de SAP Ariba Procurement [página 281]

Documentos QuoteRequest enviados por Soluciones de SAP Ariba Procurement

Cuando un agente de compras crea una solicitud de sourcing para una solicitud de compra en una de las Soluciones de SAP Ariba Procurement, un archivo cXML de solicitud de sourcing, también conocido como documento QuoteRequest, se envía a SAP Ariba Sourcing. El archivo contiene detalles de los artículos en línea en la solicitud de compra.

En las solicitudes de sourcing enviadas por Soluciones de SAP Ariba Procurement, el elemento Identity del elemento Sender en Header tiene el valor Buyer: seguido por el ID de Ariba Network del sitio que envía la solicitud de sourcing. Los detalles de cada artículo en línea de la solicitud de compra se envían utilizando un elemento QuoteItemOut en el elemento QuoteRequest.

Guía de soluciones cXMLSolicitudes de oferta

PUBLICPÚBLICO 279

Page 280: 355a de soluciones cXML - help.sap.com

Documento de ejemplo QuoteRequest enviado por soluciones SAP Ariba

El documento QuoteRequest de muestra siguiente contiene los detalles de dos artículos en línea con las descripciones Aircraft y AirPart.

Código de ejemplo

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "%cxmlSource%"><cXML timestamp="2014-12-04T14:59:46+05:30" payloadID="1417685386200.809200779.000000002@M0gq09EOjMo5PAOF3eZazxOPhjY=" xml:lang="en-US" version="1.2.023"> <Header> <!-- class: ariba.encoder.xml.AXComponent --> <From> <!-- class: ariba.encoder.xml.AXComponent --> <Credential domain="NetworkId"> <!-- class: ariba.encoder.xml.AXComponent --> <Identity>Buyer:AN02001100452</Identity> </Credential> </From> <To> <!-- class: ariba.encoder.xml.AXComponent --> <Credential domain="NetworkId"> <!-- class: ariba.encoder.xml.AXComponent --> <Identity>ACM:AN02001100452</Identity> </Credential> </To> <Sender> <Credential domain="NetworkId"> <!-- class: ariba.encoder.xml.AXComponent --> <Identity>Buyer:AN02001100452</Identity> <SharedSecret>***shared secret removed***</SharedSecret> </Credential> <UserAgent>Buyer 13s25</UserAgent> </Sender> </Header> <Request> <QuoteRequest> <QuoteRequestHeader quoteReceivingPreference="winningOnly" type="New" requestDate="Wed Dec 03 17:17:32 IST 2014" requestID="PR18"> </QuoteRequestHeader> <!-- class: ariba.purchasing.sourcing.RequisitionSourcingRequestEncodeBodyContent --> <QuoteItemOut quantity="5.0000000000" lineNumber="1"> <ItemDetail> <UnitPrice> <!-- class: ariba.procure.server.cxml.MoneyComponent --> <Money alternateCurrency="" alternateAmount="" currency="USD">100</Money> </UnitPrice> <Description xml:lang="en">Aircraft</Description> <UnitOfMeasure>5 each</UnitOfMeasure> </ItemDetail> </QuoteItemOut> <QuoteItemOut quantity="4.0000000000" lineNumber="2"> <ItemDetail> <UnitPrice> <!-- class: ariba.procure.server.cxml.MoneyComponent --> <Money alternateCurrency="" alternateAmount="" currency="USD">10</Money> </UnitPrice>

280PUBLICPÚBLICO

Guía de soluciones cXMLSolicitudes de oferta

Page 281: 355a de soluciones cXML - help.sap.com

<Description xml:lang="en">AirPart</Description> <UnitOfMeasure>4 each</UnitOfMeasure> </ItemDetail> </QuoteItemOut> </QuoteRequest> </Request> </cXML>

Documentos QuoteMessage enviados a Soluciones de SAP Ariba Procurement

Cuando el proyecto de sourcing se haya procesado y la puja se haya adjudicado a los proveedores, el agente de sourcing genera y envía las condiciones de determinación de precios resultantes de SAP Ariba Sourcing a la solución de facturación o compras de SAP Ariba en un archivo cXML llamado documento QuoteMessage.

Un único archivo cXML contiene las condiciones de determinación de precios para todos los artículos en línea de la solicitud de compra. El ID del proveedor se menciona en el elemento Identity del elemento OrganizationID. Las condiciones de determinación de precios de cada artículo en línea se mencionan en el elemento QuoteItemIn. El elemento PricingConditions contiene detalles adicionales acerca de las condiciones de determinación de precios, como cargos y descuentos.

Documento QuoteMessage de muestra enviado a las soluciones de SAP Ariba

El siguiente archivo de condiciones de determinación de precios de muestra contiene las condiciones de determinación de precios para el artículo en línea Nc1. Se ha adjudicado al proveedor con el ID de sistema de comprador SID515.

Código de ejemplo

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "%CXMLDTDURL%"><!-- class: ariba.cxml.Component --><cXML timestamp="2019-11-12T20:04:44-08:00" payloadID="%payload-id%" xml:lang="en-US" version="1.2.046"> <Header> <!-- class: ariba.encoder.xml.AXComponent --> <From> <!-- class: ariba.encoder.xml.AXComponent --> <Credential domain="SpendManagementNetwork"> <!-- class: ariba.encoder.xml.AXComponent --> <Identity>ACM:AN02001565298</Identity> </Credential> </From> <To> <!-- class: ariba.encoder.xml.AXComponent --> <Credential domain="SpendManagementNetwork"> <!-- class: ariba.encoder.xml.AXComponent --> <Identity>Buyer:AN02001565298</Identity> </Credential> </To>

Guía de soluciones cXMLSolicitudes de oferta

PUBLICPÚBLICO 281

Page 282: 355a de soluciones cXML - help.sap.com

<Sender> <Credential domain="SpendManagementNetwork"> <!-- class: ariba.encoder.xml.AXComponent --> <Identity>ACM:AN02001565298</Identity> <SharedSecret>dummy</SharedSecret> </Credential> <UserAgent>ACM 14s1</UserAgent> </Sender> </Header> <!-- class: ariba.sourcing.integration.networkrfq.QuoteDataMessageEncode --> <Message> <QuoteMessage> <QuoteMessageHeader type="award" quoteID="ID105918" quoteDate="2019-11-12T20:04:07-08:00" currency="USD"xml:lang="en"> <OrganizationID> <Credential domain="buyersystemid"> <Identity>SID515</Identity> </Credential> </OrganizationID> <Total> <Money currency="USD">120.00</Money> </Total> <QuoteRequestReference requestDate="2019-11-12T19:34:37-08:00" requestID="%req-id%"/> </QuoteMessageHeader> <!-- class: ariba.sourcing.integration.networkrfq.QuoteMessageEncode --> <QuoteItemIn rank="1" lineNumber="%line-item%" quantity="1" type="award"> <ItemID> <SupplierPartID>RANDOM123</SupplierPartID> <SupplierPartAuxiliaryID></SupplierPartAuxiliaryID> <BuyerPartID></BuyerPartID> </ItemID> <ItemDetail> <UnitPrice> <Money alternateAmount="" alternateCurrency="" currency="">Money</Money> <PricingConditions> <ValidityPeriods> <!--Period Q1--> <ValidityPeriod from='01.01.2020' to='31.03.2020'> <ConditionTypes> <!--Price for Q1--> <ConditionType name='Price'> <CostTermValue> <Money currency="USD">120</Money> </CostTermValue> <Scales scaleType="From"> <Scale from ='0'> <CostTermValue> <Money currency='USD'>120</Money> </CostTermValue> </Scale> <Scale from ='100'> <CostTermValue> <Money currency='USD'>110</Money> </CostTermValue> </Scale> <Scale from ='500'> <CostTermValue> <Money currency='USD'>100</Money> </CostTermValue> </Scale> </Scales> </ConditionType> <!--Discount for Q1--> <ConditionType name='Discount'> <CostTermValue> <Money currency='USD'>-5</Money>

282PUBLICPÚBLICO

Guía de soluciones cXMLSolicitudes de oferta

Page 283: 355a de soluciones cXML - help.sap.com

</CostTermValue> <Scales scaleType="From"> <Scale from ='0'> <CostTermValue> <Money currency='USD'>-20</Money> </CostTermValue> </Scale> <Scale from ='100'> <CostTermValue> <Money currency='USD'>-15</Money> </CostTermValue> </Scale> <Scale from ='500'> <CostTermValue> <Money currency='USD'>-10</Money> </CostTermValue> </Scale> </Scales> </ConditionType> </ConditionTypes> </ValidityPeriod> <!--Period Q2--> <ValidityPeriod from='01.04.2020' to='30.06.2020'> <ConditionTypes> <!--Price for Q2--> <ConditionType name='Price'> <CostTermValue > <Money currency="USD">125</Money> </CostTermValue> <Scales scaleType="From"> <Scale from ='0'> <CostTermValue> <Money currency='USD'>125</Money> </CostTermValue> </Scale> <Scale from ='100'> <CostTermValue> <Money currency='USD'>115</Money> </CostTermValue> </Scale> <Scale from ='500'> <CostTermValue> <Money currency='USD'>105</Money> </CostTermValue> </Scale> </Scales> </ConditionType> <!--Surcharge for Q2--> <ConditionType name='Discount'> <CostTermValue> <Money currency='USD'>5</Money> </CostTermValue> <Scales scaleType="From"> <Scale from ='0'> <CostTermValue> <Money currency='USD'>-10</Money> </CostTermValue> </Scale> <Scale from ='100'> <CostTermValue> <Money currency='USD'>-5</Money> </CostTermValue> </Scale> <Scale from ='500'> <CostTermValue> <Money currency='USD'>-15</Money> </CostTermValue> </Scale>

Guía de soluciones cXMLSolicitudes de oferta

PUBLICPÚBLICO 283

Page 284: 355a de soluciones cXML - help.sap.com

</Scales> </ConditionType> </ConditionTypes> </ValidityPeriod> </ValidityPeriods> </PricingConditions> </UnitPrice> <Description xml:lang="en">Nc1</Description> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="unspsc">2513</Classification> <ManufacturerPartID></ManufacturerPartID> <ManufacturerName></ManufacturerName> <URL></URL> <LeadTime>3</LeadTime> </ItemDetail> <Total> <Money currency="USD">120.00</Money> </Total> </QuoteItemIn> </QuoteMessage> </Message></cXML>

284PUBLICPÚBLICO

Guía de soluciones cXMLSolicitudes de oferta

Page 285: 355a de soluciones cXML - help.sap.com

Facturas y pagos programados

Los proveedores generan facturas manualmente, mediante cXML InvoiceDetailRequests o documentos EDI. Las organizaciones compradoras utilizan los pagos programados (documentos PaymentProposalRequest) para informar a Ariba Network y a sus proveedores sobre pagos planificados.

Funcionalidad de factura básica [página 285]

Coincidencia de pedidos de compra [página 286]

Reglas de negocio de facturación [página 287]

Consejos de implementación de facturas [página 289]

Transmisión de facturas a organizaciones de compras [página 346]

Estado y cancelación de facturas [página 346]

Ejemplo de factura de resumen (varios pedidos de compra) [página 348]

Factura de nivel de cabecera de ejemplo [página 351]

Factura de pedido de compra global de ejemplo [página 354]

Ejemplo de un escenario comprador/proveedor complejo [página 357]

Pagos programados [página 368]

Funcionalidad de factura básicaLos proveedores pueden generar facturas manualmente con el generador de facturas en línea (conversión de PO), mediante documentos cXML InvoiceDetailRequest o mediante documentos EDI ANSI X12 810 o EDIFACT INVOIC. Los proveedores pueden utilizar uno de estos métodos sin modificar la configuración de Ariba Network, pero sólo debe usarse un método por pedido de compra.

Ariba Network hace que coincida cada factura con su pedido de compra correspondiente y las compara con las reglas de negocio de facturación de las organizaciones compradoras.

Las facturas aparecen en las bandejas de salida en línea de los proveedores y en las bandejas de entrada en línea de las organizaciones compradoras. Los dos socios comerciales pueden ver las facturas y su estado actualizado mientras se mueven por el ciclo de vida de la factura. Las facturas proporcionan enlaces a documentos asociados, como pedidos de compra, acuerdos maestros y abonos y notas de débito.

Los compradores deben habilitar la regla para los proveedores para crear facturas basadas en pedido y facturas sin pedido. Los proveedores pueden enviar notas de cargo a través de cXML, pero Ariba Network no admite su creación en línea mediante las páginas Crear factura.

Ariba Network puede dirigir las facturas desde los proveedores hasta Ariba Buyer (7.1 y posterior). También puede dirigir el estado de la factura (documentos StatusUpdateRequest) desde estas organizaciones hasta los proveedores. Ariba Buyer lleva a cabo la reconciliación de factura para que coincidan los cargos de las facturas con los artículos de los pedidos de compra.

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 285

Page 286: 355a de soluciones cXML - help.sap.com

Coincidencia de pedidos de compraLas facturas hacen referencia a pedidos de compra preexistentes, acuerdos maestros o abonos o notas de débito. Estos documentos pueden residir en Ariba Network, o pueden ser documentos externos (documentos no orientados mediante Ariba Network). Ambos Ariba Network y Ariba Buyer intentan encontrar documentos preexistentes buscándolos.

Los proveedores insertan uno de los elementos siguientes en facturas para hacer referencia a pedidos de compra o acuerdos maestros preexistentes:

● OrderReference: (método preferido) Un elemento DocumentReference que contiene el pedido de compra/acuerdo maestro payloadId.

● OrderIDInfo: El pedido de compra/acuerdo maestro orderID y su orderDate.

Coincidencia en Ariba Network

Ariba Network lleva a cabo la coincidencia de documentos inmediatamente después de la validación cXML para buscar pedidos de compra o acuerdos maestros preexistentes.

● Si las facturas utilizan un ID de carga, pero este valor no coincide con los pedidos de compra en Ariba Network, Ariba Network considera que los pedidos de compra son externos.

● Si las facturas sólo utilizan orderID y orderDate, Ariba Network intenta que coincidan según el número de pedido de compra y la fecha de pedido opcional.

● Si las facturas sólo utilizan orderID y orderDate, y si estos valores coinciden con varios pedidos de compra, Ariba Network rechaza las facturas.

● Si las facturas utilizan ID de carga y orderID, Ariba Network comprueba que estos valores coincidan con los mismos pedidos de compra. Si no coinciden, Ariba Network considera que el pedido de compra es externo, aunque payloadID coincida con un pedido de compra.

● Si las facturas coinciden con un pedido de compra obsoleto, Ariba Network rechaza las facturas.

Coincidencias perfectas

Si Ariba Network coincide correctamente con pedidos de compra o acuerdos maestros, crea hiperenlaces en línea disponibles en ellos para los dos socios comerciales.

A continuación, Ariba Network evalúa los contenidos de la factura frente a las reglas de negocio de la organización compradora (consulte Reglas de negocio de facturación [página 287].)

Coincidencias incorrectas

Si Ariba Network no puede coincidir con un pedido de compra, trata la factura como si perteneciera a un pedido de compra externo, que es cualquier pedido de compra que no se orientó mediante Ariba Network.

286PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 287: 355a de soluciones cXML - help.sap.com

Las organizaciones compradoras configuran sus cuentas de Ariba Network para permitir o rechazar facturas frente a pedidos de compra externos. Para obtener más información, consulte Reglas de negocio de facturación [página 287].

Coincidencias en Ariba BuyerDe forma predeterminada, Ariba Buyer busca pedidos de compra o acuerdos maestros preexistentes utilizando el OrderReference payloadID de las facturas. Si las facturas no contienen este valor, coincide mediante OrderIDInfo (número de pedido de compra).

Si Ariba Buyer no encuentra pedidos de compra referenciados, genera excepciones de factura sin coincidencias. Estas excepciones enumeran detalles de factura y permiten que los solicitantes hagan coincidir manualmente las facturas con los pedidos de compra. Si los solicitantes no encuentran coincidencias, pueden rechazar las facturas, y Ariba Buyer envía documentos StatusUpdateRequest cXML a Ariba Network para fijar el estado de la factura en "rechazado".

Las organizaciones compradoras pueden configurar Ariba Buyer para que rechace automáticamente las facturas que no coinciden con los pedidos de compra. También pueden personalizar la lógica que utiliza Ariba Buyer para la coincidencia de documentos.

Reglas de negocio de facturaciónCuando las organizaciones compradoras habilitan sus cuentas de Ariba Network para la facturación, especifican reglas de negocio de facturación. Estas reglas especifican los requisitos básicos del proceso de facturación.

Entre los ejemplos de reglas de negocio se incluyen:

● Permitir que las facturas que contienen información detallada del servicio para bienes y artículos en línea pero que no se basan en hojas de entrada de servicios. Son facturas con elementos InvoiceDetailServiceItem (introducidas en cXML 1.2.009). Para los artículos en línea de servicio, el nombre del atributo puede ser IsShippingServiceItem, IsSpecialHandlingServiceItem, ServiceLocation (contiene elemento de contacto) o una cadena de texto arbitraria.

● Permitir facturas contra pedidos de compra (no Ariba Network) externos.● Permitir facturas contra pedidos de tarjeta de compra/tarjeta de crédito.● Permitir facturas de no servicio para cambiar la divisa, el precio por unidad, la unidad de medida, el número de

pieza, expedir a o facturar a.● Permitir que las facturas tengan cantidades o artículos en línea adicionales.● Permitir a los usuarios ver facturas en Ariba Network desde la aplicación ERP.

Todas las organizaciones compradoras pueden establecer estas reglas de negocio de forma diferente.

Si Ariba Network recibe facturas, prueba los contenidos contra estas reglas de negocio. Ariba Network no orienta facturas que no pasan. Envía notificaciones por correo electrónico a los proveedores (no a organizaciones compradoras) y no envía documentos de estado cXML.

NotaSAP Ariba Cloud Integration Gateway recibe las facturas y las envía a Ariba Network. Si la factura se transmite correctamente, el Indicador de transacción en Cloud Integration Gateway la mostrará como correcta. A

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 287

Page 288: 355a de soluciones cXML - help.sap.com

continuación, Ariba Network envía una StatusUpdate a la Cloud Integration Gateway para la factura de las reglas de negocio de compradores. El estado de la factura en el indicador de transacción no se actualizará pero puede asignar la StatusUpdate recibida por SAP Ariba Cloud Integration Gateway a los formatos de reconocimiento de proveedores.

Para cualquier otro tipo de documento, cuando SAP Ariba Cloud Integration Gateway publica del documento, Ariba Network responde de forma sincrónica y el estado se refleja en el Indicador de transacción de la transacción.

Reglas que sólo afectan a la conversión de PO

Algunas reglas de negocio sólo afectan a los pedidos de cliente creados manualmente (conversión de PO), pero no a las facturas generadas mediante cXML, EDI o CSV.

Las reglas de negocio siguientes afectan sólo a las facturas de conversión de PO:

● Permitir un cambio en la información Expedir a● Permitir un cambio en la información Facturar a● Permitir la entrada directa de impuesto de ventas

Visibilidad de reglas de negocio de proveedor

Los proveedores pueden ver la configuración de la regla de negocio de facturación de sus clientes mediante sus cuentas de Ariba Network. Los proveedores deben comprender las capacidades de sus clientes antes de generar facturas.

Para ver las reglas de negocio de facturación de un cliente, los proveedores van al área de compradores de sus cuentas de Ariba Network y hace clic en el nombre del cliente. Si las reglas de facturación no están enumeradas, el cliente no acepta las facturas mediante Ariba Network.

Validación numérica

Ariba Network no lleva a cabo ninguna validación numérica en artículos en línea, totales o costes en facturas cXML.

Ariba Network no valida errores matemáticos. Por ejemplo, si una factura cXML enumera el precio por unidad de 50€ y la cantidad 5, Ariba Network no comprobará si el subtotal es 250€. La discrepancia no generará un error de validación.

De manera similar, Ariba Network no lleva a cabo ninguna validación numérica de importes en documentos ConfirmationRequest que hacen referencia a facturas. En concreto, Ariba Network no comprueba el elemento PartialAmount. PartialAmount permite que las organizaciones compradoras especifiquen importes pagados diferentes a los importes especificados en las facturas.

288PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 289: 355a de soluciones cXML - help.sap.com

Consejos de implementación de facturasLas aplicaciones de SAP Ariba tienen requisitos específicos para los contenidos de las facturas.

Firmas electrónicas [página 289]

Elemento IdReference [página 293]

Funciones de contacto [página 295]

Conversión de segmento en AccountingSegment [página 295]

Atributo payloadID de factura [página 296]

Elemento ServiceEntryItemReference [página 296]

Elementos SerialNumber [página 297]

Elemento PaymentTerm [página 297]

ID de envío [página 298]

Abonos y abonos de artículo en línea [página 298]

Verificación de facturas basada en el recibo de bienes [página 299]

Atributo Fecha de inspección [página 302]

Elemento PriceBasisQuantity [página 302]

Atributo itemType [página 302]

Atributo compositeItemType [página 303]

Elemento Tolerancias [página 306]

Categoría TaxDetail [página 307]

Impuesto de expedición y manipulación especial [página 307]

Deducciones o descuentos y cargos [página 309]

Impuestos parafiscales franceses [página 317]

Soporte de retención fiscal [página 322]

Campos obligatorios para países con un sistema de IVA [página 323]

Facturas para proveedores de México [página 328]

Elementos extrínsecos para facturas [página 332]

Longitudes de campo del elemento de factura [página 345]

Adjuntos de copia de la factura en PDF [página 345]

Firmas electrónicas

Las firmas digitales proporcionan un método electrónico de autentificación de los creadores de los documentos y para garantizar la integridad del contenido. También se utilizan para cumplir los requisitos específicos de país, incluyendo el IVA.

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 289

Page 290: 355a de soluciones cXML - help.sap.com

Las firmas digitales permiten a las organizaciones compradoras y a los proveedores probar que una factura no está alterada, según las leyes locales. Si una factura firmada digitalmente se modifica después de la firma, la firma digital no es válida.

Ariba Network puede aplicar una firma digital a las facturas generadas en línea, a través de cXML, EDI o CSV. Ariba Network compara los países de origen y de destino en la factura para determinar si la factura se debe firmar digitalmente. Si el país requiere firmas digitales, Ariba Network firma la factura digitalmente. Algunos países requieren firmas digitales para el país de origen y el de destino.

Para determinar el país de origen y el de destino, Ariba Network comprueba en el cXML de InvoiceDetail la información siguiente en el pedido indicado. Si el país no se puede determinar, Ariba Network no firma la factura digitalmente.

Pedido País de origen determinado por... País de destino determinado por...

1 Prefijo del NIF/CIF del representante fiscal Prefijo del NIF/CIF del comprador

2 Código del país del representante fiscal Código de país de elemento "Expedir a" (nivel de cabe­cera)

3 Prefijo del NIF/CIF del proveedor Código de país de elemento "Expedir a" (artículo en línea)

4 Código de país de elemento "Desde"

El país especificado en el campo Expedir a determina la divisa del cliente.

Las facturas firmadas digitalmente son compatibles con cualquier versión de Ariba Buyer que acepte facturas. Las versiones de Ariba Buyer anteriores a 8.2 aceptan facturas firmadas, pero no autentifican firmas digitales. Las organizaciones compradoras europeas deben asignar espacio de disco para almacenar los 3-4 kilobytes adicionales por factura de las firmas digitales.

En la página Revisar factura, Ariba Network especifica que la factura se firmará digitalmente. Ariba Network también firma las facturas actualizadas y canceladas que genere. Ariba Network no aplica una firma digital para facturas en papel, facturas ICS (facturas enviadas a partir de un proveedor de servicios de conversión de facturas) o facturas marcadas con el extrínseco invoiceSubmissionMethod.

Para obtener más información acerca de los requisitos actuales del certificado de facturación para varios países europeos, consulte https://knowledge.ariba.com/Ariba_eSigning_CountryMatrix .

Facturas de proveedor autofirmadas [página 290]

Restricciones de la firma electrónica [página 291]

Facturas ICS [página 291]

Otros documentos de origen de factura [página 292]

Facturas de proveedor autofirmadas

Ariba Network admite facturas autofirmadas Los proveedores que implementan su propia solución de firma digital (mediante cXML) pueden crear facturas autofirmadas.

Este proceso presupone que el proveedor es el emisor de la factura y que este puede validar en nombre del comprador. Por lo tanto, el proveedor debe utilizar el método de validación de la firma para la canonicalización tal como se describe en las especificaciones W3C antes de firmar la factura.

290PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 291: 355a de soluciones cXML - help.sap.com

Los proveedores son libres de usar su lógica empresarial establecida para determinar cuándo y cómo firmar electrónicamente de la forma siguiente:

● Qué facturas firmar (en algunos casos, el proveedor puede decidir no aplicar ninguna firma electrónica)● Qué combinaciones de países de origen y destino utilizar● Qué certificados utilizar para firmar facturas

Restricciones de la firma electrónica

Los compradores deben comprender el proceso del proveedor para firmar electrónicamente y validar en su nombre. Si la factura no puede canonicalizarse antes de firmar, falla cualquier validación de terceros (por ejemplo, Infomosaic, Apache) de la firma. La función de firma digital de SAP Ariba utiliza TrustWeaver como ASP de firma digital de terceros.

NotaSe recomienda usar Apache para la validación de firmas (y no Microsoft.NET). Consulte http://www.w3.org/TR/xml-c14n y http://en.wikipedia.org/wiki/Canonical_XML para obtener más información acerca de la canonicalización de XML.

Información relacionada

Proceso de firma digitalCertificados digitales [página 41]

Facturas ICS

El extrínseco invoiceSubmissionMethod indica los medios utilizados para enviar la factura. Ariba Network utiliza este extrínseco para asignar un valor a las facturas creadas en línea para la generación de informes y lo utiliza para determinar si firmar las facturas digitalmente. Los proveedores de servicio de conversión de facturas utilizan el extrínseco con el valor PaperViaICS.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.020/InvoiceDetail.dtd">... <InvoiceDetailRequestHeader invoiceDate="2008-08-11T01:34:42+01:00" invoiceID="280064482" operation="new" purpose="standard" ...> <Extrinsic name="invoiceSubmissionMethod">PaperViaICS</Extrinsic> </InvoiceDetailRequestHeader>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 291

Page 292: 355a de soluciones cXML - help.sap.com

...

Otros valores para invoiceSubmissionMethod son: Online, EDI, cXML, PaperInvoice, SupplierPunchIn y CSVUpload.

Si una factura se recibe de un proveedor de servicios de conversión de facturas, la columna Método de envío en la interfaz de usuario de la cuenta de Ariba Network y el elemento invoiceSubmissionMethod de cXML contienen los valores siguientes:

● Si la factura se ha enviado con un valor en el extrínseco nvoiceSubmissionMethod, Ariba Network retiene este valor y lo muestra en cXML y en la cuenta de Ariba Network.

● Si la factura se envía sin ningún valor en el extrínseco invoiceSubmissionMethod, el invoiceSubmissionMethod en cXML muestra "PaperViaICS" y la columna Método de envío en la cuenta de Ariba Network muestra "Factura en papel ICS".

NotaEl extrínseco invoiceSubmissionMethod sustituye el extrínseco heredado convertedInvoiceData, que indica cómo se creó la factura. Utilice invoiceSubmissionMethod en su lugar.

Información relacionada

Guía sobre la conversión de facturas de Ariba Network

Otros documentos de origen de factura

El extrínseco invoiceSourceDocument se utiliza con fines de informes para mostrar el documento de origen referenciado en la factura. El valor es una de las siguientes cadenas: PurchaseOrder, SalesOrder, Contract, ExternalPurchaseOrder, o Time_ExpenseSheet.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.020/InvoiceDetail.dtd">... <InvoiceDetailRequestHeader invoiceDate="2008-08-11T01:34:42+01:00" invoiceID="280064482" operation="new" purpose="standard" invoiceOrigin="supplier"> <Extrinsic name="invoiceSourceDocument">Contract</Extrinsic> <Extrinsic name="invoiceSubmissionMethod">SupplierPunchin</Extrinsic> </InvoiceDetailRequestHeader> ...

Si los proveedores envían una factura sin pedido o un abono mediante cXML o EDI, deben comprobar que se especifica un valor en el extrínseco invoiceSourceDocument . Este valor extrínseco se utiliza para mostrar el documento de origen referenciado en la factura.

292PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 293: 355a de soluciones cXML - help.sap.com

● Si el comprador ha activado la regla, “Requerir a los proveedores que proporcionen información de pedido.” en la cuenta de comprador de Ariba Network, se necesita un valor en uno de los campos de información del pedido para las facturas enviadas mediante cXML o EDI. El valor introducido en el extrínseco invoiceSourceDocument se muestra en el campo Documento de origen.

● Si el comprador no ha habilitado la regla, el valor de los campos Información del pedido es opcional y se puede dejar en blanco para las facturas enviadas mediante cXML o EDI. El cXML se genera con un atributo orderID vacío. Sin embargo, los proveedores deben garantizar que introducen la cadena, "NoOrderInformation" en el extrínseco invoiceSourceDocument si no hay ningún valor en los campos Información del pedido. Si la cadena no se proporciona en el extrínseco, el campo Documento de origen se deja en blanco.

<Extrinsic name="invoiceSourceDocument">NoOrderInformation</Extrinsic>

NotaLa cadena "NoOrderInformation" distingue entre mayúsculas y minúsculas y debe escribirse exactamente tal y como se menciona aquí.

Elemento IdReference

Los socios comerciales deben comprender cómo generar y utilizar el valor IdReference en los elementos InvoicePartner.

Por ejemplo, en la mayoría de los casos, los dominios accountID y bankRoutingID se deben usar como una pareja con Contact role remitTo.

Ejemplo

<InvoicePartner> <Contact role="remitTo"> <Name xml:lang="en-US">Supplier Accts. Receivable</Name> <PostalAddress> <Street>One Bank Avenue</Street> <City>Any City</City> <State>CA</State> <PostalCode>94087</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> </Contact> <IdReference identifier="123456789" domain="bankRoutingID" /> <IdReference identifier="3456" domain="accountID" /> </InvoicePartner>

Para algunas relaciones comerciales, el accountID puede no hacer referencia a un ID de cuenta bancaria. Puede ser un ID asignado al proveedor por la organización compradora.

Detalles adicionales sobre dominios IdReference:

● accountPayableID: Número de suministrador de la organización compradora para el proveedor.● accountReceivableID: Número de cliente del proveedor para la organización compradora.

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 293

Page 294: 355a de soluciones cXML - help.sap.com

● creditorRefID: Especifica el número de referencia del acreedor para un InvoicePartner.● departmentName: identifica la dirección y el formato honorífico japonés en Ariba Network. Además, permite

introducir el nombre de la persona u organización a la que se entrega el servicio.● gstID: Identificador del impuesto sobre bienes y servicios para las organizaciones de Canadá.● stateTaxID y provincialTaxID: Intercambiables, sólo representan diferentes descripciones globalizadas.● supplierReference: ID de referencia de proveedor interno utilizado para identificar documentos salientes

para el usuario proveedor.● vatID: Identificador de IVA para organizaciones que cumplen con los requisitos de IVA.

Información ACH

La información ACH proporciona detalles sobre dónde enviar los pagos.

Ejemplo

<InvoicePartner> <Contact role="receivingBank"> <Name xml:lang="en-US">Wells Fargo Bank</Name> </Contact> <IdReference identifier="121042882" domain="abaRoutingNumber" /> <IdReference identifier="Workchairs Savings" domain="accountName" /> <IdReference identifier="34567890" domain="accountID" /> <IdReference identifier="Savings" domain="accountType" /> <IdReference identifier="Sunnyvale" domain="branchName" /> </InvoicePartner>

Información de transferencia

La información de transferencia proporciona detalles sobre dónde enviar los pagos.

Ejemplo

<InvoicePartner> <Contact role="wireReceivingBank"> <Name xml:lang="en-US">BankAmerica</Name> </Contact> <IdReference identifier="121042882" domain="swiftID" /> <IdReference identifier="12345678" domain="ibanID" /> <IdReference identifier="Workchairs Savings" domain="accountName" /> <IdReference identifier="123456" domain="accountID" /> <IdReference identifier="Savings" domain="accountType" /> <IdReference identifier="Sunnyvale" domain="branchName" /> </InvoicePartner>

294PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 295: 355a de soluciones cXML - help.sap.com

Información de referencia del acreedor

La información de referencia del acreedor para el InvoiceParter se puede incluir en la información de contacto para lograr ciclos de pago rápidos.

Ejemplo

<InvoicePartner> <Contact role="wireReceivingBank"> <Name xml:lang="en-US">BankAmerica</Name> </Contact> <IdReference identifier="121042882" domain="swiftID" /> <IdReference identifier="12345678" domain="ibanID" /> <IdReference identifier="Workchairs Savings" domain="accountName" /> <IdReference identifier="123456" domain="accountID" /> <IdReference identifier="Savings" domain="accountType" /> <IdReference identifier="Sunnyvale" domain="branchName" /> <IdReference identifier="RF70 1234 5611 2233" domain="creditorRefID" /> </InvoicePartner>

Funciones de contacto

Las facturas pueden proporcionar Contact roles que definen el nombre y la dirección del proveedor y el nombre y la dirección del comprador.

Las Contact roles pueden tener los valores siguientes:

● from: Nombre y dirección del proveedor.● soldTo: Nombre, correo electrónico y dirección del comprador.● billTo: Nombre y dirección del comprador.● remitTo: Dirección del proveedor.● shipFrom: Dirección de expedición del proveedor con dirección de correo electrónico, si existe.● shipTo: Nombre y dirección del comprador.● receivingBank: Nombre del banco que ha recibido un pago electrónico.● wireReceivingBank: Nombre del banco que ha recibido una transferencia.

El elemento Contact de InvoiceDetailShipping tiene las funciones siguientes: shipFrom y shipTo. Las dos funciones son necesarias.

La role="remitTo" puede tener opcionalmente un atributo addressID.

Conversión de segmento en AccountingSegment

El elemento Segment está en desuso y se ha sustituido por el elemento AccountingSegment en cXML 1.2.005.

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 295

Page 296: 355a de soluciones cXML - help.sap.com

Cuando los proveedores generan facturas manualmente a través de sus cuentas Ariba Network, Ariba Network se transforma cualquier elemento Segment de los pedidos de compra en elementos AccountingSegment para las facturas.

Atributo payloadID de factura

El payloadID en la cabecera del documento de factura debe ser un valor unívoco para todos los documentos. Si el payloadID no es unívoco, la factura no se generará y no aparecerá ningún mensaje de error.

Las facturas también deben contener el payloadID del pedido de compra o acuerdo maestro correspondiente. Utilice las directrices para formular payloadID en la Guía de referencia de cXML en http://www.cxml.org .

NotaPara las facturas, SAP Ariba Cloud Integration Gateway no requiere la referencia payloadID, pero el sobre cXML para el ID de carga útil es necesario. Por ejemplo, el proveedor solo necesita enviar <OrderID="1234567890"> y dejar el ID de carga útil en blanco, <DocumentReference payloadID=""/>.

Información relacionada

Coincidencia de pedidos de compra [página 286]

Elemento ServiceEntryItemReference

El elemento ServiceEntryItemReference hace referencia al artículo en línea de la hoja de entrada de servicios en el que se basa el artículo en línea de la factura.

ServiceEntryItemReference tiene los atributos siguientes:

Un elemento nuevo que hace referencia a la hoja de entrada de servicios que se origina. Tiene los atributos siguientes:

● serviceEntryDate, la fecha en la que se creó la hoja de entrada de servicios● serviceEntryID, el identificador único para la hoja de entrada de servicios● serviceLineNumber, el número en línea de la hoja de entrada de servicios

Incluye un elemento <DocumentReference> que hace referencia a la misma hoja de entrada de servicios. Por ejemplo:

<InvoiceDetailItem invoiceLineNumber="1" quantity="1"> <UnitOfMeasure>EA</UnitOfMeasure> <UnitPrice> <Money currency="USD">9000</Money> </UnitPrice> <InvoiceDetailItemReference lineNumber="1"> <ItemID> <SupplierPartID>cat1010m</SupplierPartID>

296PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 297: 355a de soluciones cXML - help.sap.com

</ItemID> <Description xml:lang="en-US"></Description> </InvoiceDetailItemReference> <ServiceEntryItemReference serviceEntryDate="2013-08-12T21:03:20-07:00" ServiceEntryID="SES-HC-t1" serviceLineNumber="1"> <DocumentReference payloadID="[email protected]"> </DocumentReference> </ServiceEntryItemReference> <SubtotalAmount> <Money currency="USD">9000</Money> </SubtotalAmount> <GrossAmount> <Money currency="USD">9000</Money> </GrossAmount> <NetAmount> <Money currency="USD">9000</Money> </NetAmount> </InvoiceDetailItem>

Elementos SerialNumber

Los proveedores sólo pueden identificar artículos facturados mediante la especificación de sus números de serie. Los proveedores pueden insertar uno o más elementos SerialNumber en elementos InvoiceDetailItemReference:

<SerialNumber>45993823469876</SerialNumber> <SerialNumber>45993823469877</SerialNumber> <SerialNumber>45993823469878</SerialNumber>

El atributo serialNumber está en desuso en cXML 1.2.009 y se ha sustituido por el elemento SerialNumber. Ariba Network muestra los dos atributos serialNumber y elementos SerialNumber.

Elemento PaymentTerm

El elemento PaymentTerm permite a los proveedores especificar descuentos o penalizaciones basados en la fecha de pago. Las condiciones de pago pueden provenir de los siguientes pedidos de compra.

Las organizaciones compradoras pueden permitir o no permitir modificaciones en las condiciones de pago en Ariba Network. Independientemente de si permiten que los proveedores editen las condiciones de pago, Ariba Network acepta las modificaciones de las condiciones de pago para los pedidos de compra que no especifican estas condiciones.

Las organizaciones compradoras también pueden requerir la presencia de condiciones de pago en las facturas.

Las facturas estándar y las notas de débito pueden tener condiciones de pago; sin embargo, Ariba Network rechaza abonos y notas de crédito de artículo en línea que tengan condiciones de pago.

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 297

Page 298: 355a de soluciones cXML - help.sap.com

ID de envío

Las organizaciones compradoras pueden requerir a los proveedores que identifiquen de forma consistente las direcciones de envío con un valor de ID unívoco. Los proveedores deben rellenar el atributo Contact addressID en este ID.

Ejemplo

<InvoicePartner> <Contact role="remitTo" addressID="1234"> <Name xml:lang="en">Joan Bill</Name> <PostalAddress name="billing department"> <DeliverTo>Joan Bill</DeliverTo> <Street>16 Castro Street</Street> <City>Mountain View</City> <State>CA</State> <PostalCode>95035</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> . . . </Contact> . . . </InvoicePartner>

La organización compradora puede asignar un valor de ID unívoco para cada dirección de proveedor. El proveedor debe usar el ID adecuado para la organización compradora.

Abonos y abonos de artículo en línea

Los proveedores pueden emitir crédito para sus clientes enviando abonos y abonos de artículo en línea. Para emitir un crédito, los proveedores deben enviar un abono de nivel de cabecera o un abono de artículo en línea con un importe negativo.

Sus clientes deben configurar su cuenta de Ariba Network para aceptar abonos de artículo en línea. Si sus clientes no configuran sus cuentas, Ariba Network trata un abono de artículo en línea como una factura estándar.

Ejemplo

En el ejemplo siguiente se muestra el elemento InvoiceDetailRequestHeader de un abono de artículo en línea:

<InvoiceDetailRequest> <InvoiceDetailRequestHeader invoiceID="CRDO12042" purpose="lineLevelCreditMemo" operation="new" invoiceDate="2001-12-04T18:00:00-07:00"> <InvoiceDetailHeaderIndicator/> <InvoiceDetailLineIndicator/> <Comments xml:lang="en-US"> Buyer ordered 5 Computer Video Cables and 3 Wireless Keyboards.

298PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 299: 355a de soluciones cXML - help.sap.com

We invoiced the customer for 8 Cables by mistake. </Comments>

NotaPara que el abono de artículo en línea contenga un enlace a la factura original, los proveedores deben proporcionar el elemento DocumentReference con el atributo payloadID configurado al payloadID de la factura original (<DocumentReference payloadID="PreviousInvoicePayloadId"/>). Por ejemplo, <DocumentReference payloadID="[email protected]"/>. Para proveedores sin cXML, InvoiceIDInfo es una alternativa aceptable. El ejemplo del elemento InvoiceDetailRequestHeader sólo muestra el invoiceID proporcionado en el abono.

Verificación de facturas basada en el recibo de bienes

Para la verificación de facturas basada en el recibo de bienes con SAP Ariba Invoice Management

Las líneas de factura reconciliadas contra los recibos de bienes se transfieren al sistema ERP externo.

● Cuando se aprueba una factura, las líneas de factura con referencias a las líneas de pedido marcadas como Aviso de expedición necesario se separan por líneas de recibo de bienes que coincidan con el artículo de la factura.

● Se generan varios segmentos InvoiceDetailOrder para cada artículo en línea de factura: Uno para cada línea de recibo de bienes coincidente y uno para cada línea de manipulación especial y de expedición.

La verificación de facturas basada en el recibo de bienes requiere integración y asignación personalizada. Su sistema ERP externo debe estar configurado para enviar la información necesaria.

Si su sistema ERP externo es SAP ERP, esta función funciona con los adaptadores existentes sin necesidad de asignaciones adicionales, a excepción del control de devoluciones que requiere que la asignación personalizada pase el ID de recibo original.

Pedido cXML

En el cXML de los pedidos de compras, los artículos en línea pensados para la verificación basada en recibos de bienes deben estar marcados de la siguiente manera:

<InvoiceInstruction value="isNotERS" verificationType="goodsReceipt"></InvoiceInstruction>

Recibo cXML y control de devoluciones

Los recibos importados del sistema ERP deben incluir el ID de aviso de expedición.

<ShipNoticeIDInfo shipNoticeID="GR_ASN_007"></ShipNoticeIDInfo>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 299

Page 300: 355a de soluciones cXML - help.sap.com

El ID de aviso de expedición es necesario para desencadenar la coincidencia automática de líneas de factura con recibos. Si los recibos no incluyen el ID de aviso de expedición asociado, los controladores de excepción de factura deben hacer coincidir manualmente las líneas de factura con los recibos disponibles. Asegúrese de que los procesos de entrada de datos de recepción y la configuración del sistema admiten que los usuarios incluyan el ID de aviso de expedición correcto al crear los recibos.

Las devoluciones se procesan como recibos negativos. El cXML de las devoluciones debe incluir una referencia al recibo original para especificar para que recibo de bienes es la devolución. Los extrínsecos ReceiptReference y ReceiptReferenceDate llevan esta información en la sección ReceiptRequestHeader de CopyReceipt.

<ReceiptRequestHeader receiptID=”ReversalOfGR1" receiptDate="2017-08-15T15:42:11-07:00" operation="new"> <Extrinsic name="ReceiptReference">GR1</Extrinsic> <Extrinsic name="ReceiptReferenceDate">2017-08-15T15:42:11-07:00</Extrinsic> </ReceiptRequestHeader>

Factura cXML

El cXML de las facturas basadas en recibos de bienes incluye el ID de aviso de expedición a nivel de cabecera y a nivel de línea. SAP Ariba Invoice Management obtiene el ID de aviso de expedición del elemento ShipNoticeIDInfo a nivel de línea.

Información de aviso de expedición a nivel de cabecera:

<InvoiceDetailShipNoticeInfo> <ShipNoticeReference shipNoticeDate="2017-04-10T03:40:08-07:00" shipNoticeID="123"> <DocumentReference payloadID="[email protected]"></DocumentReference> </ShipNoticeReference> </InvoiceDetailShipNoticeInfo>

Información de aviso de expedición a nivel de línea:

<ShipNoticeIDInfo shipNoticeID="123"></ShipNoticeIDInfo>

La factura debe incluir el número de referencia asignado a los artículos en línea en el aviso de expedición de la forma siguiente:

<ShipNoticeLineItemReference shipNoticeLineNumber="1"></ShipNoticeLineItemReference>

En SAP ERP, el campo ID de nota de entrega de una factura se rellena con el valor shipNoticeID de la factura cXML. Si no hay ningún valor shipNoticeID (por ejemplo, para proveedores integrados que no crean facturas en Ariba Network), el campo ID de nota de entrega se rellena con la información de referencia de ID del elemento ShipNoticeIDInfo.

<ShipNoticeIDInfo shipNoticeID="Packing Slip ID"> <IdReference domain="deliveryNoteID" identifier="Delivery Note ID"/> <IdReference domain="deliveryNoteLineItemNo" identifier="Delivery Note Line #"/> </ShipNoticeIDInfo>

300PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 301: 355a de soluciones cXML - help.sap.com

Reconciliación de factura cXML

El cXML para reconciliaciones de facturas incluye la información siguiente para cada artículo en línea:

● Información de aviso de expedición (en InvoiceDetailItem):

<ShipNoticeIDInfo shipNoticeID="GR_ASN_773"></ShipNoticeIDInfo>

● Recibo asociado (en InvoiceDetailOrder):

<InvoiceDetailReceiptInfo> <ReceiptReference receiptID="1" receiptDate="2017-08-15T15:42:11-07:00"> <DocumentReference payloadID="111bb333.34314"/> </ReceiptReference> </InvoiceDetailReceiptInfo>

● Número de línea del artículo en el recibo asociado (en InvoiceDetailItem):

<ReceiptLineItemReference receiptLineNumber="1"></ReceiptLineItemReference>

Ejemplo

A continuación, un extracto de muestra de una reconciliación de factura cXML que incluye la información del aviso de expedición y del recibo de un artículo de la factura.

<InvoiceDetailOrder> <InvoiceDetailOrderInfo> <OrderReference orderID="4500001075"> <DocumentReference payloadID="E662E25605B7FA2CE10000000A4C42BD"></DocumentReference> </OrderReference> </InvoiceDetailOrderInfo> <InvoiceDetailReceiptInfo> <ReceiptReference receiptID="1" receiptDate="2017-08-15T15:42:11-07:00"> <DocumentReference payloadID="111bb333.34314"/> </ReceiptReference> </InvoiceDetailReceiptInfo> <InvoiceDetailItem invoiceLineNumber="1" quantity="5"> <ShipNoticeIDInfo shipNoticeID="GR_ASN_773"></ShipNoticeIDInfo> <ReceiptLineItemReference receiptLineNumber="1"></ReceiptLineItemReference> <GrossAmount> <Money alternateCurrency="" alternateAmount="" currency="USD">82.67</Money> </GrossAmount> <NetAmount> <Money alternateCurrency="" alternateAmount="" currency="USD">82.67</Money> </NetAmount> </InvoiceDetailItem> </InvoiceDetailOrder>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 301

Page 302: 355a de soluciones cXML - help.sap.com

Atributo Fecha de inspección

En algunos países, como en Japón, es necesario especificar en las facturas cuándo ocurre la transferencia de productos o la entrega de servicios.

Los proveedores especifican fechas de inspección con el atributo inspectionDate, que se puede usar con los elementos InvoiceDetailItem, InvoiceDetailServiceItem, y InvoiceDetailOrderSummary.

Ejemplo

<InvoiceDetaiItem invoiceLineNumber="1" quantity="5" inspectionDate="2004-01-01T00:01:23+00:00">

Ariba Network agrega automáticamente este atributo cuando los proveedores generan facturas manualmente en sus cuentas de Ariba Network si las direcciones de los dos socios comerciales son de Japón.

Elemento PriceBasisQuantity

El elemento PriceBasisQuantity contiene la determinación de precios basada en la cantidad para un artículo en línea.

Para obtener más información, consulte Elemento PriceBasisQuantity [página 178].

Este elemento también está disponible en facturas con elementos InvoiceDetailServiceItem siempre que no se basen en hojas de entrada de servicios subyacentes. Las facturas creadas a partir de hojas de entrada de servicios no admiten elementos PriceBasisQuantity.

Atributo itemType

El atributo itemType especifica si el artículo en línea es un artículo agrupado con artículos secundarios o un artículo en línea independiente. Puede contener dos valores: "composite" para identificar un grupo de artículos o "item" para identificar un artículo en línea independiente.

En InvoiceDetailItem y InvoiceDetailServiceItem, el atributo parentInvoiceLineNumber hace referencia a los números de línea del artículo en línea principal. Los compradores pueden agrupar artículos en línea secundarios en un grupo de artículos.

Ejemplo

<InvoiceDetailItem invoiceLineNumber="1" quantity="10" itemType="composite"> <UnitOfMeasure>EA</UnitOfMeasure>

302PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 303: 355a de soluciones cXML - help.sap.com

<UnitPrice> <Money currency="USD">11.11</Money> </UnitPrice> <InvoiceDetailItemReference lineNumber="1"> <ItemID> <SupplierPartID>KYBD101E</SupplierPartID> </ItemID> <Description xml:lang="en-US">This is an item group. </Description> </InvoiceDetailItemReference> <SubtotalAmount> <Money currency="USD">111.10</Money> </SubtotalAmount> <GrossAmount> <Money currency="USD">111.10</Money> </GrossAmount> <NetAmount> <Money currency="USD">111.10</Money> </NetAmount></InvoiceDetailItem> <InvoiceDetailItem invoiceLineNumber="2" quantity="5" parentInvoiceLineNumber="1"> <UnitOfMeasure>EA</UnitOfMeasure> <UnitPrice> <Money currency="USD">11.11</Money> </UnitPrice> <InvoiceDetailItemReference lineNumber="1001"> <ItemID> <SupplierPartID>KYBD101E</SupplierPartID> </ItemID> <Description xml:lang="en-US">This is a child line</Description> </InvoiceDetailItemReference> <SubtotalAmount> <Money currency="USD">55.55</Money> </SubtotalAmount> <GrossAmount> <Money currency="USD">55.55</Money> </GrossAmount> <NetAmount> <Money currency="USD">55.55</Money> </NetAmount> </InvoiceDetailItemReference> </InvoiceDetailItem>

Atributo compositeItemType

El atributo compositeItemType se utiliza para admitir grupos de artículos en facturas sin pedido.

● El atributo compositeItemType se utiliza para la etiqueta DTD Item.mod. Sus posibles valores son groupLevel y itemLevel.

● La entidad compositeItemType se agrega como un atributo opcional a los elementos siguientes:○ ItemIn○ ItemOut○ InvoiceDetailItem○ ConfirmationItem○ ShipNoticeItem○ ReceiptItem

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 303

Page 304: 355a de soluciones cXML - help.sap.com

En el ejemplo siguiente se muestra un grupo de artículos con tipo de determinación de precios de nivel de grupo:

<InvoiceDetailOrder> <InvoiceDetailOrderInfo> <OrderIDInfo orderID=""></OrderIDInfo> </InvoiceDetailOrderInfo> <InvoiceDetailItem quantity="1" invoiceLineNumber="1" itemType="composite" compositeItemType="groupLevel"> <UnitOfMeasure></UnitOfMeasure> <UnitPrice> <Money currency="USD">21.00</Money> </UnitPrice> <InvoiceDetailItemReference lineNumber="1"> <ItemID> <SupplierPartID>1</SupplierPartID> </ItemID> <Description xml:lang="en">Parent Item</Description> </InvoiceDetailItemReference> <TotalAllowances> <Money currency="USD">25.00</Money> </TotalAllowances> <TotalAmountWithoutTax> <Money currency="USD">290.00</Money> </TotalAmountWithoutTax> <NetAmount> <Money currency="USD">290.00</Money> </NetAmount> </InvoiceDetailItem> <InvoiceDetailItem invoiceLineNumber="2" quantity="15" parentInvoiceLineNumber="1" itemType="item"> <UnitOfMeasure>33</UnitOfMeasure> <UnitPrice> <Money currency="USD">21.00</Money> </UnitPrice> <InvoiceDetailItemReference lineNumber="1"> <ItemID> <SupplierPartID>1</SupplierPartID> </ItemID> <Description xml:lang="en">Child Item</Description> </InvoiceDetailItemReference> <SubtotalAmount> <Money currency="USD">315.00</Money> </SubtotalAmount> <GrossAmount> <Money currency="USD">290.00</Money> </GrossAmount> <InvoiceItemModifications> <Modification> <AdditionalDeduction> <DeductionAmount> <Money currency="USD">47.25</Money> </DeductionAmount> <DeductionPercent percent="15"></DeductionPercent> </AdditionalDeduction> <ModificationDetail name="Contract Allowance"> <Description xml:lang="en"/> </ModificationDetail> </Modification> </InvoiceItemModifications> <TotalAllowances> <Money currency="USD">25.00</Money> </TotalAllowances> <TotalAmountWithoutTax> <Money currency="USD">290.00</Money> </TotalAmountWithoutTax> <NetAmount> <Money currency="USD">290.00</Money>

304PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 305: 355a de soluciones cXML - help.sap.com

</NetAmount> </InvoiceDetailItem> </InvoiceDetailOrder>

En el ejemplo siguiente se muestra un grupo de artículos con tipo de determinación de precios de nivel de artículo:

<InvoiceDetailOrder> <InvoiceDetailOrderInfo> <OrderIDInfo orderID=""></OrderIDInfo> </InvoiceDetailOrderInfo> <InvoiceDetailItem quantity="1" invoiceLineNumber="1" itemType="composite" compositeItemType="itemLevel"> <UnitOfMeasure></UnitOfMeasure> <UnitPrice> <Money currency="USD">0.00</Money> </UnitPrice> <InvoiceDetailItemReference lineNumber="1"> <ItemID> <SupplierPartID>1</SupplierPartID> </ItemID> <Description xml:lang="en">Parent Item</Description> </InvoiceDetailItemReference> </InvoiceDetailItem> <InvoiceDetailItem invoiceLineNumber="2" quantity="15" parentInvoiceLineNumber="1" itemType="item"> <UnitOfMeasure>33</UnitOfMeasure> <UnitPrice> <Money currency="USD">21.00</Money> </UnitPrice> <InvoiceDetailItemReference lineNumber="1"> <ItemID> <SupplierPartID>1</SupplierPartID> </ItemID> <Description xml:lang="en">Child Item</Description> </InvoiceDetailItemReference> <SubtotalAmount> <Money currency="USD">315.00</Money> </SubtotalAmount> <GrossAmount> <Money currency="USD">290.00</Money> </GrossAmount> <InvoiceItemModifications> <Modification> <AdditionalDeduction> <DeductionAmount> <Money currency="USD">47.25</Money> </DeductionAmount> <DeductionPercent percent="15"/> </AdditionalDeduction> <ModificationDetail name="Contract Allowance"> <Description xml:lang="en"></Description> </ModificationDetail> </Modification> </InvoiceItemModifications> <TotalAllowances> <Money currency="USD">25.00</Money> </TotalAllowances> <TotalAmountWithoutTax> <Money currency="USD">290.00</Money> </TotalAmountWithoutTax> <NetAmount> <Money currency="USD">290.00</Money> </NetAmount> </InvoiceDetailItem> </InvoiceDetailOrder>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 305

Page 306: 355a de soluciones cXML - help.sap.com

Elemento Tolerancias

Si un pedido de compra contiene las tolerancias de cantidad de artículos en línea y de precio por unidad, estas tolerancias se aplican a las facturas creadas en Ariba Network.

Ariba Network se aplica a las tolerancias de cantidad de artículos en línea y de precio por unidad a las facturas en los documentos InvoiceDetailReqest cXML enviados mediante cXML. Las tolerancias de cantidad de artículos en línea y de precio por unidad del pedido de compra no aparecen en las facturas. Sin embargo, cuando los proveedores crean una factura, Ariba Network valida la tolerancia de cantidad de artículos en línea y la tolerancia de precio por unidad no supera el límite de tolerancia especificado en el pedido de compra.

Cuando los proveedores crean una factura para un pedido de compra cambiado, las tolerancias de cantidad de artículos en línea y de precio por unidad disponibles en el pedido de compra cambiado se utilizan para validar los artículos en línea de la factura. Las tolerancias especificadas en el pedido de compra original se ignoran.

Ariba Network se aplica a las tolerancias de cantidad de artículos en línea y de precio por unidad en las facturas de la forma siguiente:

● Cuando el comprador habilita las reglas siguientes:Permitir que los proveedores aumenten las cantidades de artículosPermitir que los proveedores aumenten las cantidades de artículos de los avisos de expediciónPermitir que los proveedores creen facturas sólo según las cantidades recibidas O Permitir que los proveedores creen facturas sólo según las cantidades expedidasCaso 1:Si la cantidad de artículos en línea recibidos o expedidos es inferior a la del pedido de compra, y si el pedido de compra tiene la tolerancia de cantidad de artículos en línea, Ariba Network permite que los proveedores sólo facturen la cantidad de artículos en línea expedidos o recibidos.Por ejemplo,Envía un pedido de compra con lo siguiente:Cantidad para el artículo en línea 1 = 100.Tolerancia de la cantidad del artículo en línea para el artículo en línea 1 = 10%. La cantidad total para el artículo en línea 1 que se puede expedir o recibir es 110.Cantidad para el artículo en línea expedido o recibido 1 = 50.Ariba Network permite que los proveedores facturen 1 artículo en línea para una cantidad de 50.Caso 2:Si la cantidad de artículos en línea recibidos o expedidos es superior a la del pedido de compra, y si el pedido de compra tiene la tolerancia de cantidad de artículos en línea, Ariba Network permite que los proveedores sólo facturen la cantidad de artículos en línea que no supere el límite de tolerancia especificado en el pedido de compra.Por ejemplo,Envía un pedido de compra con lo siguiente:Cantidad para el artículo en línea 1 = 100.Tolerancia de la cantidad del artículo en línea para el artículo en línea 1 = 10%. La cantidad total para el artículo en línea 1 que se puede expedir o recibir es 110.Cantidad para el artículo en línea expedido o recibido 1 = 150.Ariba Network permite que los proveedores facturen 1 artículo en línea para una cantidad de 110.

Para obtener más información, consulte Elemento Tolerancias [página 178].

306PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 307: 355a de soluciones cXML - help.sap.com

Categoría TaxDetail

La página Generar factura de Ariba Network permite a los proveedores especificar valores para el atributo TaxDetail category.

Por ejemplo:

<TaxDetail purpose="tax" category="gst">

Los posibles valores para las facturas generadas en Ariba Network son:

Atributo de categoría TaxDe­tail Descripción

sales Impuesto de ventas

vat Impuesto sobre el valor añadido

gst Impuesto sobre bienes y servicios

pst Impuesto de ventas por provincia

qst Impuesto de ventas para Quebec

hst Impuesto de ventas armonizado

usage Impuesto de uso

other Otra categoría de impuesto

Impuesto de expedición y manipulación especial

En algunas configuraciones locales, los proveedores deben indicar el impuesto de expedición o de manipulación especial. Agregan un elemento TaxDetail adicional e indican si es un impuesto de línea, expedición o manipulación especial con purpose="tax",purpose="shippingTax" opurpose="specialHandlingTax". Indican la categoría fiscal de forma independiente.

Sólo puede haber un importe de expedición y un importe de manipulación especial por línea, por lo que no es necesario indicar qué importe de expedición o manipulación especial se aplica al elemento TaxDetail. Los proveedores pueden especificar impuestos individuales sólo si especifican el impuesto y la expedición entre líneas, no en la cabecera. Si especifican la expedición entre líneas pero el impuesto en la cabecera, también pueden tener un elemento TaxDetail en la cabecera que se aplique al total de todos los cargos de expedición.

En el ejemplo siguiente se especifican el impuesto de línea, el impuesto de manipulación especial y el impuesto de expedición para un artículo de factura individual:

<InvoiceDetailItem invoiceLineNumber="1" quantity="10"> <UnitOfMeasure>EA</UnitOfMeasure> <UnitPrice> <Money currency="USD">500</Money> </UnitPrice> ... <SubtotalAmount> <Money currency="USD">5000</Money> </SubtotalAmount> <Tax>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 307

Page 308: 355a de soluciones cXML - help.sap.com

<!-- Tax breakdown: 5000 * 0.05 = 250 (5% tax on $5000 goods) 40 * 0.05 = 2 (5% tax on $40 shipping) 80 * 0.05 = 4 (5% tax on $80 special handling) === 256 total tax --> <Money currency="USD">256</Money> <TaxDetail purpose="tax" category="sales" percentageRate="5"> <TaxableAmount> <Money currency="USD">5000</Money> </TaxableAmount> <TaxAmount> <Money currency="USD">250</Money> </TaxAmount> <Description xml:lang="en">Sales tax on goods</Description> </TaxDetail> <TaxDetail purpose="shippingTax" category="sales" percentageRate="5"> <TaxableAmount> <Money currency="USD">40</Money> </TaxableAmount> <TaxAmount> <Money currency="USD">2</Money> </TaxAmount> <Description xml:lang="en">Sales tax on shipping</Description> </TaxDetail> <TaxDetail purpose="specialHandlingTax" category="sales" percentageRate="5"> <TaxableAmount> <Money currency="USD">80</Money> </TaxableAmount> <TaxAmount> <Money currency="USD">4</Money> </TaxAmount> <Description xml:lang="en">Sales tax on special handling</Description> </TaxDetail> </Tax> <InvoiceDetailLineSpecialHandling> <Money currency="USD">80</Money> </InvoiceDetailLineSpecialHandling> <InvoiceDetailLineShipping> <InvoiceDetailShipping> ... </InvoiceDetailShipping> <Money currency="USD">40</Money> </InvoiceDetailLineShipping> ... <!-- Gross breakdown: 5000 subtotal + 40 shipping + 80 special handling + 256 all taxes ==== 5376 gross --> <GrossAmount> <Money currency="USD">5376</Money> </GrossAmount> ... </InvoiceDetailItem>

Como práctica recomendada, utilice una numeración negativa (como por ejemplo “-1,” “-2”) para invoiceLineNumber en elementos InvoiceDetailServiceItem para cargos de expedición y de manipulación especial. Utilice "0" para lineNumber en elementos InvoiceDetailServiceItemReference para el InvoiceDetailServiceItem correspondiente para cargos de expedición y de manipulación especial.

308PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 309: 355a de soluciones cXML - help.sap.com

Si las organizaciones compradoras utilizan Ariba Network Adapter, deben especificar el impuesto del artículo en línea en pedidos de compra y requerir a los proveedores que utilicen la información fiscal en las facturas. Los proveedores pueden proporcionar el impuesto de manipulación especial en el nivel de cabecera o información del impuesto de expedición en el elemento InvoiceDetailSummary:

<InvoiceDetailSummary> ... <TaxDetail purpose="shippingTax" category="sales" percentageRate="6"> <TaxAmount> <Money currency="USD">344</Money> </TaxAmount> <Description xml:lang="en-US">Sales tax on shipping</Description> </TaxDetail> </Tax> ... </InvoiceDetailSummary>

Deducciones o descuentos y cargos

Ariba Network permite que los proveedores incluyan cargos adicionales, deducciones y los impuestos que se generan para el coste total de entrega de los bienes y servicios para los artículos en línea en una factura.

Expedición y manipulación especial

Los detalles de los cargos de expedición y manipulación especial de nivel de cabecera se envían utilizando los elementos ShippingAmount y SpecialHandlingAmount mientras los detalles de los cargos de expedición y manipulación especial de nivel de línea se envían utilizando los elementos InvoiceDetailLineShipping y InvoiceDetailLineSpecialHandling.

En el siguiente código de muestra, se ha aplicado un cargo de manipulación especial de 10€ en el artículo en línea.

Código de ejemplo

<InvoiceDetailOrder> <InvoiceDetailItem> <InvoiceDetailLineSpecialHandling> <Description xml:lang="en-US">Special handling</Description> <Money currency="USD">10.00</Money> </InvoiceDetailLineSpecialHandling> </InvoiceDetailItem></InvoiceDetailOrder><InvoiceDetailSummary> <SpecialHandlingAmount> <Money currency="USD">10.00</Money> </SpecialHandlingAmount> <TotalCharges> <Money currency="USD">10.00</Money> </TotalCharges> </InvoiceDetailSummary>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 309

Page 310: 355a de soluciones cXML - help.sap.com

Descuento

Los detalles de los descuentos aplicados en la factura se envían utilizando el elemento InvoiceDetailDiscount a nivel de cabecera y de línea.

<InvoiceDetailOrder> <InvoiceDetailItem> <InvoiceDetailDiscount> <Money currency="USD">15.00</Money> </InvoiceDetailDiscount> </InvoiceDetailItem></InvoiceDetailOrder><InvoiceDetailSummary> <InvoiceDetailDiscount> <Money currency="USD">15.00</Money> </InvoiceDetailDiscount> </InvoiceDetailSummary>

Atributo de nivel

El elemento Modification tiene un atributo opcional level, que puede tener un valor entero. Se utiliza para desviaciones y cargos compuestos y visualiza en qué nivel se aplica una modificación en concreto.

El siguiente ejemplo muestra cómo el atributo level se utiliza para un artículo con diversas modificaciones:

<InvoiceHeaderModifications> <Modification level="1"> <OriginalPrice>5.500</OriginalPrice> <AdditionalDeduction> <DeductionPercent>2</DeductionPercent> </AdditionalDeduction> </Modification> <Modification level="1"> <OriginalPrice>5.500</OriginalPrice> <AdditionalCost> <Money currency="USD">2.00</Money> </AdditionalCost> </Modification> <Modification level="2"> <OriginalPrice 7.390</OriginalPrice > <AdditionalDeduction> <DeductionPercent>10</DeductionPercent> </AdditionalDeduction> </Modification> </InvoiceHeaderModifications>

InvoiceHeaderModifications

El elemento InvoiceHeaderModifications especifica los cargos adicionales, las deducciones y los impuestos que se generan para el coste total de entrega de los bienes y servicios en el nivel de cabecera de la factura.

El elemento InvoiceHeaderModificationspuede almacenar uno o varios elementos Modification [página 158].

310PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 311: 355a de soluciones cXML - help.sap.com

El elemento AdditionalDeduction con type="withholdingTax" contiene retenciones fiscales. Para todos los artículos en línea de PaymentRemittanceRequest, el valor que se muestra en el elemento Money contenido por el elemento AdjustmentAmount es la suma de los valores que se muestran en los elementos Money contenidos por los elementos DeductionAmount, contenidos por los elementos AdditionalDeduction con los atributos type="withholdingTax" y type="other".

En PaymentRemittanceSummary, el valor que se muestra en el elemento Money contenido por el elemento AdjustmentAmount es la suma de todos los importes de ajuste en el envío.

En el ejemplo siguiente se muestran elementos AdjustmentAmount y Comments de InvoiceHeaderModifications:

<AdjustmentAmount> <Money currency="USD">110.00</Money> <Modifications> <Modification> <AdditionalDeduction type="withholdingTax"> <DeductionAmount> <Money currency="USD">95.00</Money> </DeductionAmount> </AdditionalDeduction> </Modification> <Modification> <AdditionalDeduction type="other"> <DeductionAmount> <Money currency="USD">15.00</Money> </DeductionAmount> </AdditionalDeduction> </Modificiation> </Modifications></AdjustmentAmount> <Comments>Tax Withheld</Comments>

InvoiceItemModifications

El elemento InvoiceItemModificationsespecifica los cargos adicionales, las deducciones y los impuestos para el coste total de entrega de los bienes y servicios para un artículo en línea de la factura.

El elemento InvoiceItemModificationspuede almacenar uno o varios elementos Modification. Para obtener más información acerca del elemento Modification, consulte Elemento Modifications [página 158].

TotalCharges

El elemento TotalCharges es el total de todos los cargos aplicados a los bienes y servicios. Puede aparecer en el artículo en línea y en el resumen de una factura.

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 311

Page 312: 355a de soluciones cXML - help.sap.com

TotalAllowances

El elemento TotalAllowances es el total de todos los descuentos aplicados a los bienes y servicios. Puede aparecer en el artículo en línea y en el resumen de una factura.

TotalAmountWithoutTax

El elemento TotalAmountWithoutTax se utiliza para resumir el importe total de factura sin impuestos.

El importe total incluye:

● Subtotal● Importe de expedición● Manipulación especial● Cargos

Los descuentos y las deducciones se restan de la suma de los cuatro importes anteriores.

En el ejemplo siguiente se especifican las deducciones, los cargos y sus impuestos en una factura. En el primer ejemplo se muestran cargos y deducciones de artículo en línea en el nivel de línea; en el segundo ejemplo se muestran modificaciones de precio por unidad.

● Modificaciones en el nivel de línea:

<InvoiceDetailItem invoiceLineNumber = "1" quantity = "1"> <UnitOfMeasure>ea</UnitOfMeasure> <UnitPrice> <Money currency = "USD">1000.00</Money> </UnitPrice> <InvoiceDetailItemReference lineNumber = "1"> <ItemID> <SupplierPartID>part#1</SupplierPartID> </ItemID> <Description xml:lang = "en-US"></Description> </InvoiceDetailItemReference> <SubtotalAmount> <Money currency = "USD">1000.00</Money> </SubtotalAmount> <GrossAmount> <Money currency = "USD">1000.00</Money> </GrossAmount> <InvoiceItemModifications> <Modification> AdditionalCost> <Money currency = "USD">13</Money> </ AdditionalCost> <ModificationDetail name = "Insurance" startDate = "2013-09-06T10:15:00-08:00" endDate = "2013-09-10T10:15:00-08:00"/> </Modification> </InvoiceItemModifications> <TotalCharges> <Money currency=”USD”>13</Money> </TotalCharges> <TotalAmountWithoutTax> <Money currency=”USD”>1013</Money> </TotalAmountWithoutTax> <NetAmount> <Money currency = "USD">1013.00</Money>

312PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 313: 355a de soluciones cXML - help.sap.com

</NetAmount></InvoiceDetailItem></InvoiceDetailOrder> <InvoiceDetailSummary> <SubtotalAmount> <Money currency = "USD">1000.00</Money> </SubtotalAmount> <Tax> <Money currency = "USD">10.0</Money> <Description xml:lang = "en-US"></Description> <TaxDetail category="TaxOnAllowance" percentageRate = "10"> <TaxableAmount> <Money currency = "USD">100.00</Money> </TaxableAmount> <TaxAmount> <Money currency = "USD">10.00</Money> </TaxAmount> <Description xml:lang = "en-US"></Description> </TaxDetail> </Tax> <GrossAmount> <Money currency = "USD">1000.00</Money> </GrossAmount> <InvoiceHeaderModifications> <Money currency=”USD”>100</Money> <Modification> <AdditionalDeduction> <Money currency = "USD">100</Money> </AdditionalDeduction> <Tax> <Money currency = "USD">10.00</Money> <Description xml:lang = "en-US"></Description> <TaxDetail category="TaxOnAllowance" percentageRate="10"> <TaxableAmount> <Money currency = "USD">100.00</Money> </TaxableAmount> <TaxAmount> <Money currency = "USD">10.00</Money> </TaxAmount> <Description xml:lang = "en-US"></Description> </TaxDetail> </Tax> <ModificationDetail name = "SpecialDiscount" startDate = "2013-09-06T10:15:00-08:00" endDate = "2013-09-10T10:15:00-08:00"/> </Modification> </InvoiceHeaderModifications> <TotalCharges> <Money currency=”USD”>13</Money> </ TotalCharges> <TotalAllowances> <Money currency=”USD”>100</Money> </ TotalAllowances> <TotalAmountWithoutTax> <Money currency = "AUD">913.00</Money> </TotalAmountWithoutTax> <NetAmount> <Money currency = "USD">923.00</Money> </NetAmount> <DueAmount> <Money currency = "USD">923.00</Money> </DueAmount> </InvoiceDetailSummary> </InvoiceDetailRequest>

● Modificaciones en el nivel de precio por unidad:

<InvoiceDetailItem invoiceLineNumber="1" quantity="10">

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 313

Page 314: 355a de soluciones cXML - help.sap.com

<UnitOfMeasure>LB</UnitOfMeasure> <UnitPrice> <Money currency="USD">15.00</Money> <Modifications> <Modification> <OriginalPrice> <Money currency="USD">25.00</Money> </OriginalPrice> <AdditionalDeduction> <DeductionAmount> <Money currency="USD">10.00</Money> </DeductionAmount> </AdditionalDeduction> <ModificationDetail name="Discount-Special"> <Description xml:lang="en">Test Discount</Description> </ModificationDetail> </Modification> </Modifications> </UnitPrice> <InvoiceDetailItemReference lineNumber="1"> <ItemID> <SupplierPartID>1</SupplierPartID> </ItemID> <Description xml:lang="en">Test Item 1</Description> </InvoiceDetailItemReference> <SubtotalAmount> <Money currency="USD">150.00</Money> </SubtotalAmount> <GrossAmount> <Money currency="USD">150.00</Money> </GrossAmount> <TotalAmountWithoutTax> <Money currency="USD">150.00</Money> </TotalAmountWithoutTax> <NetAmount> <Money currency="USD">150.00</Money> </NetAmount></InvoiceDetailItem><InvoiceDetailSummary> <SubtotalAmount> <Money currency="USD">150.00</Money> </SubtotalAmount> <Tax> <Money currency="USD">0</Money> <Description xml:lang="en"/> </Tax> <GrossAmount> <Money currency="USD">150.00</Money> </GrossAmount> <InvoiceDetailSummaryLineItemModifications> <Modification> <AdditionalDeduction> <DeductionAmount> <Money currency="USD">100.00</Money> </DeductionAmount> </AdditionalDeduction> <ModificationDetail name="Discount-Special"> <Description xml:lang="en">Test Discount</Description> </ModificationDetail> </Modification> </InvoiceDetailSummaryLineItemModifications> <TotalAmountWithoutTax> <Money currency="USD">150.00</Money> </TotalAmountWithoutTax> <NetAmount> <Money currency="USD">150.00</Money> </NetAmount> <DueAmount>

314PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 315: 355a de soluciones cXML - help.sap.com

<Money currency="USD">150.00</Money> </DueAmount></InvoiceDetailSummary>

Descuentos y cargos en dinero o porcentuales

Los ejemplos siguientes muestran cómo agregar deducciones y cargos como un porcentaje o como un importe fijo:

● Modificación en el nivel de cabecera con cargo del importe

<InvoiceHeaderModifications> <Modification> <AdditionalCost> <Money currency="USD">25.00</Money> </AdditionalCost> <ModificationDetail name="Other charges"> <Description xml:lang="en">Test Charge</Description> </ModificationDetail> </Modification></InvoiceHeaderModifications>

● Modificación en el nivel de cabecera con cargo porcentual

<InvoiceHeaderModifications> <Modification> <AdditionalCost> <Percentage percent="10"/> </AdditionalCost> <ModificationDetail name="Other charges"> <Description xml:lang="en">Test Charge</Description> </ModificationDetail> </Modification></InvoiceHeaderModifications>

● Modificación en el nivel de línea con cargo del importe

<InvoiceItemModifications> <Modification> <AdditionalCost > <Money currency="USD">25.00</Money> </AdditionalCost> <ModificationDetail name="Other charges"> <Description xml:lang="en">Test Charge Line</Description> </ModificationDetail> </Modification></InvoiceItemModifications>

● Modificación en el nivel de línea con cargo porcentual

<InvoiceItemModifications> <Modification> <AdditionalCost > <Percentage percent="10"/> </AdditionalCost> <ModificationDetail name="Other charges"> <Description xml:lang="en">Test Charge Line</Description> </ModificationDetail> </Modification></InvoiceItemModifications>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 315

Page 316: 355a de soluciones cXML - help.sap.com

● Modificación en el nivel de cabecera con deducción del importe

<InvoiceHeaderModifications> <Modification> <AdditionalDeduction> <DeductionAmount><Money currency="USD">5.00</Money></DeductionAmount> </AdditionalDeduction> <ModificationDetail name="Volume Discount"> <Description xml:lang="en"> Test Discount</Description> </ModificationDetail> </Modification></InvoiceHeaderModifications>

● Modificación en el nivel de cabecera con deducción porcentual

<InvoiceHeaderModifications> <Modification> <AdditionalDeduction> <DeductionPercent percent="10"/> </AdditionalDeduction> <ModificationDetail name="Volume Discount"> <Description xml:lang="en"> Test Discount</Description> </ModificationDetail> </Modification></InvoiceHeaderModifications>

● Modificación en el nivel de línea con deducción del importe

<InvoiceItemModifications> <Modification> <OriginalPrice> <Money currency="USD">25.00</Money> </OriginalPrice> <AdditionalDeduction> <DeductionAmount><Money currency="USD">5.00</Money></DeductionAmount> </AdditionalDeduction> <ModificationDetail name="Discount-Special"> <Description xml:lang="en">Test Discount Line</Description> </ModificationDetail> </Modification></InvoiceItemModifications>

● Modificación en el nivel de línea con deducción porcentual

<InvoiceItemModifications> <Modification> <OriginalPrice> <Money currency="USD">25.00</Money> </OriginalPrice> <AdditionalDeduction> <DeductionPercent percent="10"/> </AdditionalDeduction> <ModificationDetail name="Discount-Special"> <Description xml:lang="en">Test Discount Line</Description> </ModificationDetail> </Modification></InvoiceItemModifications>

316PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 317: 355a de soluciones cXML - help.sap.com

Nombres ModificationDetail

Los valores siguientes se pueden utilizar para el atributo name de ModificationDetail:

● Access Charge● AccountNumberCorrectionCharge● AcidBattery● AdditionalPackaging● Adjustment● Allowance● Carrier● Charge● ChargeForCommercialDiscount● ChargeForPreferentialPositioning● ChargesForReturnedGoods● CollectionFee● Contract Allowance● CustomFees● Discount-Special● FinancialFees● Freight● FreightBasedOnDollarMinimum● Insurance● Handling● Honorarium● Labelling● OrderCharges● OtherCharges● OrderOfFullPalette● Packaging● Parafiscal Tax● ReturnableGoodsCharge● Royalties● ServiceCharges● Volume Discount

Impuestos parafiscales franceses

Ariba Network permite a los proveedores incluir impuestos parafiscales franceses en facturas. Los impuestos parafiscales son impuestos obligatorios, recopilados para fondos dedicados e impuestos por la ley francesa. Los proveedores pueden agregar impuestos parafiscales franceses utilizando los elementos siguientes:

● ModificationDetail nombre Parafiscal Tax. Se utiliza para cargos del tipo impuesto parafiscal.● Nombre extrínseco code. Se utiliza para el código del impuesto parafiscal agregado.

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 317

Page 318: 355a de soluciones cXML - help.sap.com

El extracto cXML siguiente muestra ejemplos de Parafiscal Tax ModificationDetail con los impuestos parafiscales disponibles:

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Droit eaux et boissons non alcool </Description> <Extrinsic name="code">3001000002008</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Droit spécif or argent et platine</Description> <Extrinsic name="code">3001000002022</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Taxe forestière</Description> <Extrinsic name="code">3001000002039</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Taxe CODIFAB</Description> <Extrinsic name="code">3001000002046</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Taxe DEFI</Description> <Extrinsic name="code">3001000002060</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Redevance édition et ouvr librairie</Description> <Extrinsic name="code">3001000002077</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Taxe HBJOAT</Description> <Extrinsic name="code">3001000002084</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Surtaxe sur les eaux minérales</Description> <Extrinsic name="code">3001000002091</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Taxe financement organisme agricole</Description> <Extrinsic name="code">3001000002107</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Redevance sanitaire d'abattage</Description> <Extrinsic name="code">3001000002114</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Taxe municipale sur l'électricité</Description> <Extrinsic name="code">3001000002169</Extrinsic> </ModificationDetail>

318PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 319: 355a de soluciones cXML - help.sap.com

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Taxe département sur l'électricité</Description> <Extrinsic name="code">3001000002176</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Redevance sanitaire de découpage</Description> <Extrinsic name="code">3001000002183</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Cotisation Interbev</Description> <Extrinsic name="code">3001000002190</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Taxe CTIFL</Description> <Extrinsic name="code">3001000002206</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Octroi de mer</Description> <Extrinsic name="code">3001000002213</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">TICGN</Description> <Extrinsic name="code">3001000002237</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Cotisation Unicid</Description> <Extrinsic name="code">3001000002244</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">CVRO Gazon</Description> <Extrinsic name="code">3001000002251</Extrinsic> </ModificationDetail>

<Description xml:lang="fr">Taxe du CN du cinématographe</Description> <Extrinsic name="code">3001000002268</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Taxe CIFOG</Description> <Extrinsic name="code">3001000002275</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Contribution Eco-emballages</Description> <Extrinsic name="code">3001000002282</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">TIPP</Description> <Extrinsic name="code">3001000002299</Extrinsic> </ModificationDetail>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 319

Page 320: 355a de soluciones cXML - help.sap.com

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">TGAP</Description> <Extrinsic name="code">3001000002305</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Droits d'accises sur les alcools</Description> <Extrinsic name="code">3001000002312</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Cotisation sécurité sociale</Description> <Extrinsic name="code">3001000002329</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Contribution Corepile</Description> <Extrinsic name="code">3001000002336</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Cotisation Interfel</Description> <Extrinsic name="code">3001000002367</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Cotisation label viande</Description> <Extrinsic name="code">3001000002381</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Taxe CETIM</Description> <Extrinsic name="code">3001000002398</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Autre CVO interprofessionnelle</Description> <Extrinsic name="code">3001000002404</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Taxe d'abattage</Description> <Extrinsic name="code">3001000002411</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">CTA Gaz</Description> <Extrinsic name="code">3001000002435</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">CSPE</Description> <Extrinsic name="code">3001000002442</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Contribution DEEE</Description> <Extrinsic name="code">3001000002459</Extrinsic>

320PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 321: 355a de soluciones cXML - help.sap.com

</ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">CTA Electricité</Description> <Extrinsic name="code">3001000002466</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Rémunération pour copie privée</Description> <Extrinsic name="code">3001000002473</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Contribution pour une pêche durable</Description> <Extrinsic name="code">3001000002480</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Redevance pour pollutions diffuses</Description> <Extrinsic name="code">3001000002497</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Taxe pour le dvpt ind construction</Description> <Extrinsic name="code">3001000002503</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Compensation gaz tarif solidarité</Description> <Extrinsic name="code">3001000002510</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Contribution Eco TLC</Description> <Extrinsic name="code">3001000002527</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Taxe vidéogrammes</Description> <Extrinsic name="code">3001000002534</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">Taxe sur les prémix</Description> <Extrinsic name="code">3001000002541</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">CSE Porc</Description> <Extrinsic name="code">3001000002596</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">TICFE</Description> <Extrinsic name="code">3001000002619</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax">

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 321

Page 322: 355a de soluciones cXML - help.sap.com

<Description xml:lang="fr">TDCFE</Description> <Extrinsic name="code">3001000002626</Extrinsic> </ModificationDetail>

<ModificationDetail name="Parafiscal Tax"> <Description xml:lang="fr">TCCFE</Description> <Extrinsic name="code">3001000002633</Extrinsic></ModificationDetail>

Soporte de retención fiscal

Ariba Network permite a los usuarios y compradores especificar el importe de la retención fiscal amount en el nivel de línea de las facturas para servicios o mercancías. La organización compradora paga este tipo de impuesto a las autoridades fiscales del estado o del gobierno en nombre del proveedor.

Al elemento cXML Tax pueden agregarse dos elementos extrínsecos:

● withholdingTax (para retenciones fiscales totales) y● withholdingTaxTotal (para impuestos totales menos retención fiscal)

El elemento Money en el elemento Tax se utiliza para capturar totales para todos los importes de impuestos y no se utiliza para la visualización de la factura. El uso de tipos negativos garantiza la compatibilidad con versiones anteriores de aplicaciones cXML existentes.

Ejemplo

El ejemplo siguiente muestra cómo se ven los datos de la retención fiscal en una factura cuando se exportan a cXML. A la factura se le aplicó un tipo de retención fiscal del -2 % y esta se envió vía Ariba Network:

<Tax><Money currency="USD">1273.35</Money><Description xml:lang="en-US"></Description> <TaxDetail category="withholdingTax" percentageRate="-2"> <TaxableAmount><Money currency="USD">25466.90</Money></TaxableAmount> <TaxAmount><Money currency="USD">-509.34</Money></TaxAmount> <Description xml:lang="en-US"></Description> </TaxDetail> <TaxDetail category="vat" percentageRate="7" taxPointDate="2011-03-11T00:00:00-08:00"> <TaxableAmount><Money currency="USD">25466.90</Money></TaxableAmount> <TaxAmount><Money currency="USD">1782.69</Money></TaxAmount> <Description xml:lang="en-US"></Description> </TaxDetail> <Extrinsic name="withholdingTaxTotal"><Money currency="USD">-509.34</Money></Extrinsic> <Extrinsic name="taxTotal"><Money currency="USD">1782.69</Money></Extrinsic> </Tax>

322PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 323: 355a de soluciones cXML - help.sap.com

Campos obligatorios para países con un sistema de IVA

Las organizaciones compradoras deben requerir que las facturas contengan datos ordenados por los países que utilizan sistemas de IVA. Los proveedores deben comprobar las reglas de facturación de sus clientes en Ariba Network para ver si estos campos son obligatorios.

Descripción de artículo en línea obligatoria [página 323]

Facturar a obligatorio [página 323]

Enviar a obligatorio [página 324]

Expedir de y Expedir a obligatorios [página 325]

ID obligatorio: NIF/CIF de comprador y de proveedor [página 326]

Información de proveedor obligatoria [página 326]

Fecha de suministro obligatoria [página 327]

IVA obligatorio en divisa local del comprador y del proveedor [página 327]

Explicación obligatoria de entradas de IVA con valor cero [página 328]

Descripción de artículo en línea obligatoria

En algunos países, las descripciones de artículo en línea son obligatorias.

Ejemplo

En el ejemplo siguiente se muestra una descripción de artículo en línea:

<InvoiceDetailItemReference lineNumber="1"> ... <Description xml:lang="en">Blue Ballpoint Pens, Retractable</Description> </InvoiceDetailItemReference>

Facturar a obligatorio

En algunos países es necesario un contacto Facturar a obligatorio.

Ejemplo

En el siguiente ejemplo se muestra un contacto Facturar a:

<InvoicePartner>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 323

Page 324: 355a de soluciones cXML - help.sap.com

<Contact role="billTo" addressID="4319"> <Name xml:lang="en">Mike Smith</Name> <PostalAddress name="default"> <DeliverTo>Mike Smith</DeliverTo> <Street>15 Rue Des Fleurs</Street> <City>Libourne</City> <PostalCode>33506</PostalCode> <Country isoCountryCode="FR">France</Country> </PostalAddress> <Email name="default">[email protected]</Email> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="FR">33</CountryCode> <AreaOrCityCode>562</AreaOrCityCode> <Number>35820</Number> </TelephoneNumber> </Phone> </Contact> </InvoicePartner>

Enviar a obligatorio

En algunos países es necesario un contacto Enviar a obligatorio. En caso de que el contacto Enviar a sea un servicio de factoraje, también puede ser para marcarlo en las facturas.

Ejemplos

En el siguiente ejemplo se muestra un contacto Enviar a:

<InvoicePartner> <Contact role="remitTo" addressID="Billing"> <Name xml:lang="en">Lisa King</Name> <PostalAddress name="billing department"> <DeliverTo>Lisa King</DeliverTo> <Street>16 Rue De L’ecole</Street> <City>Paris</City> <PostalCode>91250</PostalCode> <Country isoCountryCode="FR">France</Country> </PostalAddress> <Email name="default">[email protected]</Email> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="FR">33</CountryCode> <AreaOrCityCode>1</AreaOrCityCode> <Number>99900</Number> </TelephoneNumber> </Phone> </Contact> <IdReference identifier="00000-11111" domain="accountReceivableID"> <Creator xml:lang="en">Supplier’s Back Office System</Creator> </IdReference> <IdReference identifier="123456789" domain="bankRoutingID"> <Creator xml:lang="en">First National Bank of Paris</Creator> </IdReference> </InvoicePartner>

324PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 325: 355a de soluciones cXML - help.sap.com

En el siguiente ejemplo se muestra un contacto Enviar a, que es un servicio de factoraje.

<InvoiceDetailRequestHeader invoiceDate="2014-06-02T16:14:13+03:00" invoiceID="IN0123" invoiceOrigin="supplier" operation="new" purpose="standard"> <InvoiceDetailHeaderIndicator/> <InvoiceDetailLineIndicator/> <InvoicePartner> <Contact role="remitTo"> <Name xml:lang="en">Factoring Service</Name> <PostalAddress> <Street>test</Street> <City>Sofia</City> <PostalCode>1000</PostalCode> <Country isoCountryCode="BG">Bulgaria</Country> </PostalAddress> <Extrinsic name=”isFactoring”>true</Extrinsic> </Contact> </InvoicePartner> </InvoiceDetailRequestHeader>

Expedir de y Expedir a obligatorios

En algunos países, los campos Expedir de y Expedir a son obligatorios.

Ejemplo

En el siguiente ejemplo se muestra un contacto Expedir a y Expedir de si el atributo isShippingInLine no está fijado en yes:

<InvoiceDetailShipping> <Contact role="shipFrom" addressID="1000487"> <Name xml:lang="en">Supplier DotCom, Paris</Name> <PostalAddress name="default"> <Street>16 Rue De L’ecole</Street> <City>Paris</City> <PostalCode>91250</PostalCode> <Country isoCountryCode="FR">France</Country> </PostalAddress> <Email name="default">[email protected]</Email> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="FR">33</CountryCode> <AreaOrCityCode>1</AreaOrCityCode> <Number>99900</Number> </TelephoneNumber> </Phone> </Contact> <Contact role="shipTo" addressID="1000488"> <Name xml:lang="en">Libourne Headquarters</Name> <PostalAddress name="default"> <DeliverTo>Mike Smith</DeliverTo> <Street>15 Rue Des Fleurs</Street> <City>Libourne</City> <PostalCode>33506</PostalCode> <Country isoCountryCode="FR">France</Country> </PostalAddress>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 325

Page 326: 355a de soluciones cXML - help.sap.com

<Email name="default">[email protected]</Email> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="FR">33</CountryCode> <AreaOrCityCode>562</AreaOrCityCode> <Number>35820</Number> </TelephoneNumber> </Phone> </Contact> </InvoiceDetailShipping>

ID obligatorio: NIF/CIF de comprador y de proveedor

El NIF/CIF del proveedor siempre es obligatorio. El NIF/CIF del comprador es obligatorio para transacciones dentro de la UE. El comercio dentro de la UE se define como el comercio dentro de la Unión Europea, en el que el código origen y destino son de países diferentes y de la Unión Europea.

Ejemplo

En el ejemplo siguiente se muestran NIF/CIF de comprador y de proveedor:

<InvoiceDetailRequestHeader> ... <Extrinsic name="buyerVatID">SE123456789087</Extrinsic> <Extrinsic name="supplierVatID">CH987654321</Extrinsic> </InvoiceDetailRequestHeader>

Información de proveedor obligatoria

En algunos países, las autoridades fiscales requieren que los proveedores incluyan su ID de registro comercial y los detalles legales en todas las facturas electrónicas. El ID de registro comercial no es el mismo que el NIF/CIF del proveedor. Los detalles legales se utilizan para capturar información legal acerca del proveedor, como por ejemplo "CEO" u otra credencial corporativa.

NotaAriba Buyer, SAP Ariba Buying and Invoicing y SAP Ariba Invoice Management permiten la siguiente cantidad máxima de caracteres. Todos los valores de campo que superen el límite se truncarán en:

● supplierCommercialIdentifier: 50 caracteres● supplierCommercialCredentials: 100 caracteres● legalStatus: 50 caracteres● legalCapital: 50 caracteres

326PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 327: 355a de soluciones cXML - help.sap.com

Ejemplo

<InvoiceDetailRequestHeader> ... <Extrinsic name="supplierCommercialIdentifier">1234567890</Extrinsic> <Extrinsic name="supplierCommercialCredentials">CEO</Extrinsic> <Extrinsic name="legalStatus">Inc.</Extrinsic> <Extrinsic name="legalCapital">1000</Extrinsic> </InvoiceDetailRequestHeader>

Fecha de suministro obligatoria

Las entradas de IVA deben tener un elemento TaxDetail con un atributo category="vat". La fecha de suministro es obligatoria y difiere de la fecha de facturación, por lo que las entradas de IVA deben tener un atributo taxPointDate. Los compradores pueden solicitar la fecha de suministro con una regla de facturación.

Ejemplo

En el ejemplo siguiente se muestra información de IVA y una fecha de suministro:

<Tax> <Money currency="EUR">799.60</Money> <Description xml:lang="en-GB">Value Added Tax</Description> <TaxDetail category="vat" percentageRate="8" taxPointDate="2005-04-20T23:59:45+01:00"> <TaxableAmount> <Money currency="EUR">9995.00</Money> </TaxableAmount> <TaxAmount> <Money currency="EUR">799.60</Money> </TaxAmount> <TaxLocation xml:lang="en-GB">Europe</TaxLocation> </TaxDetail> </Tax>

IVA obligatorio en divisa local del comprador y del proveedor

Las entradas de IVA deben especificar valores en la divisa local del comprador y del proveedor.

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 327

Page 328: 355a de soluciones cXML - help.sap.com

Ejemplo

En el ejemplo siguiente se muestra cómo utilizar los atributos alternateAmount y alternateCurrency para especificar un importe en la divisa local de la organización compradora:

<Tax> <Money alternateAmount="5.28" alternateCurrency="GBP" currency="EUR">10.00</Money> <Description xml:lang="en-US"></Description> <TaxDetail category="vat" percentageRate="10"> <TaxableAmount> <Money currency="EUR">100.00</Money> </TaxableAmount> <TaxAmount> <Money alternateAmount="5.28" alternateCurrency="GBP" currency="EUR">10.00</Money> </TaxAmount> <Description xml:lang="en-US"></Description> </TaxDetail> </Tax>

Explicación obligatoria de entradas de IVA con valor cero

Si el IVA es del 0% para algunos bienes o servicios de la factura, los proveedores pueden especificar si el IVA está exento o del tipo impositivo cero. El atributo exemptDetail en el elemento TaxDetail es obligatorio si una organización compradora habilita la regla de facturación "Requerir explicación para el IVA=0.”

Ejemplo

< !-- Exempt Tax Detail --> <Tax> <Money currency="EUR"0.00</Money> <Description xml:lang="en-US"></Description> <TaxDetail category="vat" percentageRate="0"exemptDetail="zeroRated"> <TaxableAmount> <Money currency="EUR">100.00</Money> </TaxableAmount> <TaxAmount> <Money currency="EUR">0.00</Money> </TaxAmount> </TaxDetail> </Tax>

Facturas para proveedores de MéxicoCuando los proveedores de México (el país proveedor es México) crean facturas en Ariba Network, el documento InvoiceDetailRequest debe contener campos adicionales en los elementos TaxDetail, PostalAddress,InvoiceDetailRequestHeader. El elemento TaxDetail también contiene extrínsecos adicionales.

328PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 329: 355a de soluciones cXML - help.sap.com

NotaLos proveedores pueden integrarse directamente con un proveedor de servicios de facturación electrónica acreditado para crear facturas CFDI en el portal del proveedor de servicios o generar facturas CFDI desde su sistema contable. Las facturas de impuestos para proveedores mexicanos integrados utilizan diferentes extrínsecos. Consulte Extrínsecos de factura de impuestos [página 334].

El elemento TaxDetail contiene el elemento siguiente:

Elemento Descripción

TaxRegime Especifica la categoría de impuesto relacionada con el tipo de actividades del proveedor y las mercancías de las facturas. El régimen fiscal es la organización gobernante para una categoría de impuesto. Los proveedores pagan impuestos según el régimen fiscal.

Regímenes fiscales de muestra:

● Salarios de régimen asimilado● Régimen de pequeños contribuyentes (REPECO)● Régimen de actividades profesionales y negocios, etc.

Es un elemento opcional.Una factura puede tener uno o más regímenes fiscales, pero los proveedores sólo pueden asociar un régimen fiscal en el elemento TaxDetail. Este elemento es aplicable a todos los países.

<Tax> <Money currency = "USD">1.87</Money> <Description xml:lang = "en-US"/> <TaxDetail category="vat" percentageRate="2" taxPointDate="2013-06-19T00:00:00+05:30"> <TaxableAmount> <Money currency = "USD">93.60</Money> </TaxableAmount> <TaxAmount> <Money currency = "USD">1.87</Money> </TaxAmount> <Description xml:lang = "en-US"/> <TaxRegime>Regimen de Asalariados</TaxRegime> </TaxDetail> </Tax>

El elemento PostalAddress tiene el elemento siguiente:

Elemento Descripción

Municipality Especifica el nombre de la municipalidad de un sector del estado en la ubicación de la direc­ción. Es un elemento opcional y se agrega como parte del elemento PostalAddress.

NotaEste campo sólo es obligatorio para proveedores con país México y se utiliza para firmar facturas de México digitalmente. Si falta esta información en el elemento de dirección From, el CFDI (factura legal para México) está incompleto y el proveedor de servicios (EDI­COM) y la autoridad fiscal no aprueban el documento CFDI.

<PostalAddress> <Street>24 Mossy Creek</Street> <City>Chihuahua</City>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 329

Page 330: 355a de soluciones cXML - help.sap.com

<Municipality>Juárez</Municipality > <State>Chihuahua</State> <PostalCode>94089</PostalCode> <Country isoCountryCode = "MX">Mexico</Country> </PostalAddress>

El documento InvoiceDetailRequest también almacena el Contact role=billFrom. Este campo es obligatorio en las facturas para proveedores con país México en From y To.

Los elementos siguientes también son obligatorios en el elemento PostalAddress:

● Street● City● State● PostalCode

NotaEl campo invoiceID se puede utilizar para almacenar el número de folio para el CFDI. La longitud del campo invoiceID debe limitarse a 20 caracteres.

El InvoiceDetailRequestHeader tiene el extrínseco siguiente:

Elemento Descripción

paymentMethod Especifica la vía de pago. Valores posibles:

● Efectivo● DirectDeposit● CreditTransfer● Transferencia● Cheque● Otros

Esta información extrínseca se almacena en el Contact role="remitTo” del ele­mento InvoiceDetailRequestHeader .Los proveedores de México deben configurar como mínimo una dirección remitTo.

<Extrinsic name = "paymentMethod">creditTransfer</Extrinsic>

paymentNote Especifica el número de plazos que necesita el comprador para pagar la factura. Este valor se toma del pedido de compra, en caso de que esté disponible.

Los proveedores pueden introducir un valor para este extrínseco al crear una factura. En Ariba Network, este campo está disponible en la sección Campos adicionales en la página de crea­ción de facturas.

<Extrinsic name = "paymentNote">1 installment of 10</Extrinsic>

330PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 331: 355a de soluciones cXML - help.sap.com

Elemento Descripción

invoiceType Especifica el tipo de factura. Este extrínseco se agrega como parte del elemento InvoiceDetailRequestHeader.

Valores posibles:

● commercialInvoice● commissionInvoice● feeInvoice● rentInvoice● carrierInvoice

Este campo está disponible en las facturas para proveedores con país México en From y To.

<Extrinsic name = "invoiceType">commercialInvoice</Extrinsic>

El elemento TaxDetail tiene el extrínseco siguiente:

Elemento Descripción

WithholdingTaxType Especifica si la categoría de impuesto tiene la retención fiscal. Este extrínseco se agrega como parte del elemento TaxDetail.

Valores posibles:

● ISR● IVA

Este campo es obligatorio en las facturas para proveedores con país México en From y To.

taxType Permite que SAP Ariba Buying and Invoicing reciba y procese facturas de Ariba Network. No obstante, solo afecta a las entradas cXML de facturas de México, Italia y Colombia.

<TaxDetail category="withholdingTax" percentageRate="-1"> <TaxableAmount><Money currency="USD">99.95</Money></TaxableAmount> <TaxAmount> <Money currency="USD">-1.00</Money> </TaxAmount> <TaxLocation xml:lang="en-US">San Jose</TaxLocation> <Description xml:lang="en-US">Testing Purpose</Description> <Extrinsic name="withholdingTaxType">IVA</Extrinsic> </TaxDetail>

A continuación, encontrará los posibles errores que ocurren cuando los proveedores crean facturas desde México (el país proveedor es México) y si éstas fallan en Ariba Network:

Error Este error ocurre si......

Falta el método de pago Falta el extrínseco paymentMethod.

Falta la forma de pago Falta el extrínseco paymentNote.

Falta el tipo de factura Falta el extrínseco invoiceType.

Falta la retención fiscal Falta el extrínseco withholdingTaxType con la categoría de impuesto withholdingTax .

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 331

Page 332: 355a de soluciones cXML - help.sap.com

Error Este error ocurre si......

Falta el régimen fiscal Falta el elemento TaxRegime en uno de los elementos TaxDetails.

Falta la municipalidad en la dirección del pro­veedor

Falta el elemento Municipality en el elemento From.

Falta el contacto Facturar desde Falta el contacto del interlocutor de la factura con la función "BillFrom" en la factura.

El ID de factura supera la longitud máxima de 20 caracteres

El ID de factura supera los 20 caracteres. El ID debe ser inferior o igual a 20.

Se necesita un certificado digital El proveedor no ha cargado el certificado digital.

Se necesita un certificado digital válido El certificado digital que se ha cargado en el perfil del proveedor no es válido o ha vencido.

Falta el NIF/CIF del comprador El comprador no ha configurado el NIF/CIF en su perfil y falta el NIF/CIF en la factura.

Falta el NIF/CIF del proveedor El proveedor no ha configurado el NIF/CIF en su perfil y falta el NIF/CIF en la fac­tura.

Falta la calle 1 en la dirección del proveedor El proveedor no ha proporcionado la información sobre la calle en el elemento Contact role="From” PostalAddress.

Falta el estado en la dirección del proveedor El proveedor no ha especificado el estado en el elemento Contact role="From” PostalAddress.

Falta el código postal en la dirección del pro­veedor

El proveedor no ha especificado el código postal en el elemento Contact role="From” PostalAddress.

Falta la ciudad en la dirección Facturar desde El proveedor no ha especificado la ciudad en el elemento Contact role="bill­From” PostalAddress.

Elementos extrínsecos para facturasLos proveedores pueden incluir varios elementos Extrinsic en las facturas.

Extrínsecos personalizados

Las organizaciones compradoras pueden solicitar que las facturas contengan elementos Extrinsic personalizados. Los proveedores introducen valores para estos elementos Extrinsic en el asistente de facturas Ariba Network. Los proveedores cXML que no utilizan el asistente de facturas deben ponerse en contacto con sus clientes para ver qué elementos Extrinsic esperan.

Extrínsecos para enlaces en los que se puede hacer clic

Ariba Network puede representar URL como enlaces a los que se puede hacer clic en facturas y pedidos de compra en línea.

332PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 333: 355a de soluciones cXML - help.sap.com

Estas URL se producen mediante elementos Extrinsic en forma:

<Extrinsic name="anyname"> <URL name="click me">http://www.bigcompany.com/info</URL> </Extrinsic>

Este ejemplo produce el siguiente texto en línea:

anyname:click me

Las palabras "hacer clic" están subrayadas y puede hacer clic en ellas, y el enlace de destino es http://www.bigcompany.com/info. Si el elemento URL no tiene el atributo name, Ariba Network muestra la URL y la convierte en un enlace al que se puede hacer clic.

Extrínseco para habilitar SSO y ERP

La regla "Permitir a los usuarios ver facturas de Ariba Network en el sistema" permite a los usuarios de su organización acceder a las facturas enviadas mediante ERP cuando inician sesión en la cuenta de SAP Ariba.

Ariba Network puede incluir una URL en la factura utilizando el elemento Extrinsic siguiente:

<Extrinsic name="AribaNetwork.InvoiceDisplay"> <URL name="click me">http://www.bigcompany.com/info</URL> </Extrinsic>

Póngase en contacto con el representante del servicio de asistencia de SAP Ariba para que le ayude a activar esta función.

Extrínseco para artículos en línea de servicio

InvoiceDetailItem se pueden aplicar tanto a los bienes como a los artículos en línea de servicio en las facturas. En el caso de los artículos en línea de servicio, el nombre del atributo puede ser IsShippingServiceItem o IsSpecialHandlingServiceItem o ServiceLocation (que debe contener un elemento de contacto).

Extrínseco para títulos de documentos en polaco en la factura cXML

Los compradores pueden especificar la regla "Requerir a los proveedores que incluyan el título de factura en polaco para facturas y abonos en las facturas EDI o cXML" para permitir a los proveedores polacos (el país proveedor es Polonia o el NIF/CIF empieza con "PL") enviar facturas y abonos con títulos en polaco mediante cXML, CSV o EDI.

Los proveedores deben asegurarse de que incluyen el siguiente extrínseco al enviar facturas y abonos mediante cXML al comprador buyer:

● Facturas cXML:

<InvoiceDetailRequestHeader>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 333

Page 334: 355a de soluciones cXML - help.sap.com

<Extrinsic name="InvoiceTitle">Faktura</Extrinsic> </InvoiceDetailRequestHeader>

● Abonos cXML:

<InvoiceDetailRequestHeader> <Extrinsic name="InvoiceTitle">Faktura Korygująca</Extrinsic> </InvoiceDetailRequestHeader>

NotaSi el comprador activa la regla y el proveedor envía la factura o el abono sin el extrínseco necesario o un valor incorrecto, Ariba Network muestra un error.

Si los proveedores polacos crean una factura o un abono mediante la interfaz de usuario en Ariba Network, Ariba Network incluye automáticamente los títulos en polaco en las facturas y abonos.

Para obtener más información sobre los títulos de documento en polaco, consulte Guía para la facturación de Ariba Network.

Extrínsecos de factura de impuestos

Algunos países, como por ejemplo Australia, ordenan un indicador en las facturas que contiene cargos impositivos en orden para que las organizaciones compradoras reciban créditos de impuestos.

Los proveedores pueden indicar facturas de impuestos insertando el siguiente elemento Extrinsic en el elemento InvoiceDetailRequestHeader:

<Extrinsic name="TaxInvoice">This is a tax invoice</Extrinsic>

El nombre debe ser "TaxInvoice", pero los contenidos del elemento se ignoran. Ariba Network agrega automáticamente este elemento si los proveedores generan facturas manualmente en sus cuentas Ariba Network en caso de que dispongan de una dirección en Australia.

Los extrínsecos siguientes se utilizan para soportar la información de factura de impuestos adicional necesaria por el proveedor de servicios cuando la factura se firma legalmente. Se agregan en el elemento InvoiceDetailRequestHeader:

Nombre extrínseco Descripción

economicActivityCode Código numérico asignado por el SSI relacionado con la activi­dad económica del proveedor (para Chile).

economicActivityDescription Texto sin formato que describe la actividad económica del pro­veedor.

externalPurpose Tipo de documento DTE (para Chile).

externalVersion Este elemento contiene el formato de factura de impuestos. Entre los posibles valores se incluyen NFE, DTE, CFDI, EDIXML, XML, PDF u otros.

334PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 335: 355a de soluciones cXML - help.sap.com

Nombre extrínseco Descripción

invoiceSubmissionMethod El método de envío a Ariba Network, ya sea Online, LegalInvoiceViaXML, o NFeViaXML (para Brasil).

schemaVersion El número de versión de puntos (por ejemplo, 3.2) del for­mato de la factura XML para un país.

signatureVerifier Este elemento identifica la plataforma, que verifica la firma de la factura de impuestos y genera el informe de verificación de firma. Entre los posibles valores se incluyen BM4, BNG y AribaNetwork. El elemento no es aplicable a las facturas cXML firmadas.

signValidationDateTime Fecha y hora de la validación.

signerProvider Nombre del firmante de la factura de impuestos (por ejemplo, Self-Signed o {NombreProveedor}).

signingCertificate Certificado de firma X509.

signingRequester La organización que ha solicitado que se firme la factura (por ejemplo, AribaNetwork).

signingTime Fecha y hora de la firma.

taxInvoiceAttachmentName Nombre del archivo que contiene la firma verificada.

taxInvoiceFormat Formato de la factura de impuestos (por ejemplo, NFE, DTE, CFDI o EDIXML).

taxInvoiceNumber Número de factura de impuestos externo.

taxInvoiceRepresentation Este elemento identifica si la factura es una factura de impues­tos o no. Si el valor es Tax, la factura es una factura de im­puestos. Se utiliza para reconocer las facturas de impuestos externas.

taxInvoiceVerification Este elemento contiene información acerca del estado de firma de la factura de impuestos. Tiene dos valores posibles, Signed y Not Signed. Se utiliza para procesar las facturas de impuestos externas.

taxStampingDate Fecha y hora de la firma.

El extracto cXML siguiente muestra un ejemplo de los elementos extrínsecos utilizados para una factura de impuestos de Chile:

<Extrinsic name="buyerVatID">86160300-8</Extrinsic><Extrinsic name="supplierVatID">77546140-3</Extrinsic><Extrinsic name="invoiceSourceDocument">PurchaseOrder</Extrinsic><Extrinsic name="invoiceSubmissionMethod">Online</Extrinsic><Extrinsic name="resolutionNumber">89001</Extrinsic><Extrinsic name="resolutionDate">2014-10-22</Extrinsic><Extrinsic name="economicActivityCode">671929</Extrinsic><Extrinsic name="economicActivityDescription">EMPRESAS DE ASESORIA, CONSULTORIA FINANCIERA Y DE APOYO AL GIRO</Extrinsic><Extrinsic name="taxInvoiceNumber">224880677</Extrinsic><Extrinsic name="taxInvoiceFormat">DTE</Extrinsic>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 335

Page 336: 355a de soluciones cXML - help.sap.com

<Extrinsic name="externalSignerProvider">Signature</Extrinsic><Extrinsic name="schemaVersion">DTE-1.0</Extrinsic><Extrinsic name="taxInvoiceRepresentation">Tax</Extrinsic><Extrinsic name="taxInvoiceVerification">Signed</Extrinsic><Extrinsic name="externalPurpose">33</Extrinsic><Extrinsic name="signingCertificate">MIIDiz...</Extrinsic><Extrinsic name="taxStampingDate">2003-10-13T09:33:20</Extrinsic><Extrinsic name="signValidationDateTime">2015-01-09T08:03:36-08:00</Extrinsic><Extrinsic name="taxInvoiceAttachmentName">cid:SignedXML</Extrinsic><Extrinsic name="signingRequester">AribaNetwork</Extrinsic>

Extrínseco de tipo de cambio de divisa fiscal

Ariba Network utiliza tipos de cambio de divisa de Bloomberg para calcular importes de impuestos. Algunos países, como España, requieren que los tipos de cambio de divisa se recuperen de los tipos publicados oficialmente. Para indicar este requisito, Ariba Network permite que los proveedores introduzcan tipos de cambio de divisa en lugar de convertir automáticamente importes de impuestos a la divisa especificada.

Los proveedores pueden indicar tipos de cambio de divisa insertando el siguiente elemento Extrinsic en el elemento InvoiceDetailRequestHeader:

<Extrinsic name="taxExchangeRate">1.2</Extrinsic>

Ariba Network permite especificar un impuesto en una divisa sólo para la facturación en línea. La divisa de la organización compradora se calcula según el país especificado en la dirección Expedir a. El formulario de factura en línea no permite a los proveedores crear líneas de factura de expedición para varios países si la regla está activada. El proveedor debe introducir el tipo de cambio de divisa si los importes de impuestos son diferentes de la divisa del país de la dirección Expedir a.

Ariba Network también valida que el cXML entrante tenga importes de impuestos especificados en la divisa de la dirección Expedir a. Si se especifica la información fiscal en el nivel del artículo en línea, Ariba Network valida la información fiscal especificada en la divisa de la información Expedir a en el nivel del artículo en línea, si procede. De lo contrario, utiliza la información de Expedir a de la cabecera de la factura para la validación.

Si la información fiscal está especificada en la factura a nivel de cabecera y hay varios países para "Expedir a" a nivel de artículo en línea, Ariba Network no valida divisas de impuestos locales.

Extrínsecos para facturas enviadas por proveedores desde Brasil

Si los proveedores envían una factura NFe o CTe en un formato XML a Ariba Network, algunos de los campos de la factura XML se transforman en un extrínseco en Ariba Network.

A continuación, encontrará los extrínsecos disponibles para las facturas NFe:

Extrínseco Descripción

NFeCertificateSerialNumber El número de serie emitido por la autoridad firmante de Brasil. Este número se recupera del certificado base codificado en la factura NFe.

buyer VATID El número CNPJ del comprador brasileño.

336PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 337: 355a de soluciones cXML - help.sap.com

Extrínseco Descripción

supplier VATID El número CNPJ del proveedor brasileño.

paymentTermsCode Los detalles del método de pago preferido para la factura.

Los valores siguientes indican el método de pago preferido:

● 0 denota pagos en efectivo● 1 denota pagos a plazos● 2 denota otros

regioncode El código del estado que emite la factura.

transactiontype El tipo de transacción seleccionado por el proveedor para la factura.

Por ejemplo, el tipo de transacción incluye tareas de operación, como por ejemplo: transferencias, devoluciones, importaciones, asignaciones y expe­diciones.

customersPartNo El código asignado al producto por el proveedor.

invoiceDueDate La fecha esperada de entrega de factura al sistema del comprador.

treasuryAdditionalInformation Proporciona información de interés adicional a la autoridad fiscal de Brasil.

SEFAZEnvironment Los detalles del entorno SEFAZ desplegado.

Los valores siguientes indican el entorno SEFAZ específico:

● 1 denota Producción● 2 denota Aprobación

SEFAZSolutionAppVersion El número de versión de la aplicación SEFAZ.

externalInvoiceNumber El número de factura generado por la solución de facturación electrónica del proveedor.

SEFAZDate La fecha en la que SEFAZ ha autorizado la factura.

protocolNumber El número emitido por la autoridad fiscal de Brasil para identificar transac­ciones como autorización, denegación y cancelaciones de NFe.

digitalSignatureValue El código de firma digital emitido por la autoridad firmante de Brasil.

SEFAZResponseCode El código de autorización recibido durante la validación SEFAZ.

SEFAZResponseDescription Los detalles del estado de procesamiento de documento SEFAZ.

carrierNumberOfVolumes Los detalles del volumen total de los bienes expedidos en el transportista.

carrierSpecificationVolume La especificación detallada de los artículos expedidos para la entrega.

carrierNetWeight El peso total de los bienes facturados en el transportista.

carrierGrossWeight El peso bruto, incluidos el peso de los bienes y del transportista.

carrierTermsOfDelivery Los detalles de las condiciones de la entrega de los bienes en el transpor­tista.

carrierInscriptionState Los detalles del código de registro del estado en el transportista.

carrierVehiclePlate Los detalles del número de registro fijado en la matrícula del vehículo.

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 337

Page 338: 355a de soluciones cXML - help.sap.com

Extrínseco Descripción

carrierVehicleUFBoard El código utilizado para identificar los detalles del estado en el que se regis­tró el vehículo.

NIF/CIF El número CNPJ del transportista.

finalRecipient Los detalles de contacto del destinatario final de los bienes.

transportAllowanceOrCharge Los gastos de viaje cubiertos para expedir los bienes.

invoiceReferences Los detalles de la factura.

Contiene los dominios siguientes en el elemento IdReference:

● internalControlNumber: El número clave de acceso de 44 ca­racteres emitido por la autoridad firmante de Brasil para especificar se­ries de documentos.

● originalInvoiceNumber: El número de factura generado por la solución de facturación electrónica del proveedor o un proveedor de terceros.

● NFeKeyFromHeader: Igual que internalControlNumber.● supplierSequenceNumber: El número de factura generado por la

solución de facturación electrónica del proveedor o un proveedor de terceros.

● legalInvoiceSequence: La serie de documentos fiscales.

A continuación, encontrará los extrínsecos disponibles para las facturas CTe:

Extrínseco Descripción

supplierVatID El número CNPJ del proveedor.

buyerVatID El número CNPJ del comprador.

shipmentMethodOfPayment Los medios de pago seleccionados para los bienes expedidos.

paymentTermsCode El código asociado con el tipo de pago seleccionado por el proveedor.

regionCode El código del estado que emite la factura.

transactionType El tipo de transacción seleccionado por el proveedor para la factura.

Por ejemplo, el tipo de transacción incluye tareas de operación, como por ejemplo: transferencias, devoluciones, importaciones, asignaciones y expe­diciones.

338PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 339: 355a de soluciones cXML - help.sap.com

Extrínseco Descripción

invoiceReferences Los detalles de la factura.

Contiene los dominios siguientes en el elemento IdReference:

● CTeType: Los detalles del tipo de factura.● internalControlNumber: El número clave de acceso de 44 ca­

racteres emitido por la autoridad firmante de Brasil.● originalInvoiceNumber: El número de factura generado por la

solución de facturación electrónica del proveedor o un proveedor de terceros.

● CTeNumber: Igual que internalControlNumber.● legalInvoiceSequence: El número de serie del documento fis­

cal.

operationFiscalCode El código asociado con el tipo de tarea de operación seleccionada para la factura. Por ejemplo, transporte, entrega, importación y devolución.

netWeight Los detalles del peso total de los bienes expedidos.

carrierVehiclePlate El número que se muestra en la matrícula del vehículo.

vehicleType El tipo de vehículo utilizado para la expedición de los bienes.

transportTerms Las condiciones que se aplican durante el transporte de los bienes factura­dos.

route Los detalles de la ruta que se sigue durante la entrega de los bienes.

customersPartNo El código asignado al producto por el proveedor.

SEFAZEnvironment Los detalles del entorno SEFAZ desplegado.

Los valores siguientes indican el entorno SEFAZ específico:

● 1 denota Producción● 2 denota Aprobación

SEFAZSolutionAppVersion El número de versión de la aplicación SEFAZ.

externalInvoiceNumber El número de factura generado por la solución de facturación electrónica del proveedor.

SEFAZDate La fecha en que SEFAZ autorizó la factura.

protocolNumber El número emitido por la autoridad fiscal de Brasil para identificar transac­ciones como autorización, denegación y cancelaciones de NFe.

digitalSignatureValue El código de firma digital emitido por la autoridad firmante.

SEFAZResponseCode El código de autorización recibido durante la validación SEFAZ.

SEFAZResponseDescription Los detalles del estado de procesamiento de documento SEFAZ.

externalversion Los detalles del número de versión del documento CTe.

Los siguientes extrínsecos admiten la facturación de impuestos para las facturas de servicios de Brasil:

Extrínseco Descripción

rpsSeries El número de serie RPS alfanumérico.

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 339

Page 340: 355a de soluciones cXML - help.sap.com

Extrínseco Descripción

rpsNumber El número RPS.

verificationCode El código de verificación proporcionado por la municipalidad.

isNFSe La información acerca de si un documento es una factura elec­trónica NFS o no.

serviceCode El código de servicio numérico de cinco dígitos para identificar el tipo de servicio.

taxationType El tipo de imposición elegible para la factura de servicios espe­cífica.

isISSRetention Este es un campo Sí/No que sirve para indicar si el comprador puede retener el importe ISS en la factura de servicios especí­fica.

CNAECode El código para la actividad económica.

regionalEngineerAssociationNum El número de registro regional emitido para un proveedor para llevar a cabo servicios relacionados con la construcción.

culturalIncentive Éste es un campo de Sí/No para indicar si el proveedor es ele­gible para incentivos culturales.

simpleNational Este es un campo de Sí/No para indicar si el proveedor es un microemprendedor o una pequeña empresa.

specialTaxRegime El código de identificación de régimen especial para los im­puestos.

taxBenefitCode El código de tres dígitos que indica la elegibilidad de los benefi­cios fiscales.

issRetentionValue El valor devuelto indica el importe retenido para el impuesto ISS.

El extracto siguiente de una factura cXML muestra los extrínsecos que admiten la facturación de impuestos para las facturas de servicios de Brasil:

<Extrinsic name="rpsSeries">BBBBB</Extrinsic> <Extrinsic name="rpsNumber">110</Extrinsic> <Extrinsic name="verificationCode">QACHQ</Extrinsic> <Extrinsic name="isNFSe">yes</Extrinsic> <Extrinsic name="serviceCode"><Classification domain="saoPaulo">123456</Classification></Extrinsic> <Extrinsic name="taxationType">T</Extrinsic> <Extrinsic name="isISSRetention">yes</Extrinsic><Extrinsic name="CNAECode">222222222</Extrinsic> <Extrinsic name="regionalEngineerAssociationNum">89765478</Extrinsic> <Extrinsic name="culturalIncentive">yes</Extrinsic> <Extrinsic name="simpleNational">no</Extrinsic> <Extrinsic name="specialTaxRegime">5</Extrinsic> <Extrinsic name="taxBenefitCode">456</Extrinsic> <Extrinsic name="issRetentionValue"><Money currency="USD">10.00</Money></Extrinsic>

340PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 341: 355a de soluciones cXML - help.sap.com

Extrínsecos para facturas enviadas por proveedores de Hungría

Cambios en cXML

Para dar soporte al mantenimiento de rangos de números de facturas para proveedores de Hungría, se ha agregado el siguiente extrínseco cXML a InvoiceDetailRequestHeader:

Nombre extrínseco Este campo almacena...

taxInvoiceNumber Texto numérico que almacena el número de factura de impues­tos actual del rango configurado por el proveedor.

El siguiente extracto de cXML muestra el extrínseco del número de factura de impuestos en la cabecera de un pedido.

<Request deploymentMode="production"> <InvoiceDetailRequest> <InvoiceDetailRequestHeader invoiceDate="2016-02-03T16:41:04+08:00" invoiceID="INV001" invoiceOrigin="supplier" operation="new" purpose="standard"> … <Extrinsic name="taxInvoiceNumber">101</Extrinsic> … </InvoiceDetailRequestHeader></InvoiceDetailRequest> </Request>

Extrínsecos para facturas creadas automáticamente a partir de recibos

El siguiente extrínseco cXML contenido en InvoiceDetailRequestHeader posibilita la identificación de facturas que se han creado automáticamente a partir de recibos:

Nombre extrínseco Este campo almacena...

isAutoflip Sin valor.

El extracto cXML siguiente muestra el elemento extrínseco para las facturas que se han creado automáticamente a partir de recibos:

<InvoiceDetailRequestHeader invoiceID="InvDO12043" purpose="standard" operation="new" invoiceDate="2015-03-30T17:30:00-07:00"> <InvoiceDetailHeaderIndicator></InvoiceDetailHeaderIndicator> ... <Extrinsic name="isAutoflip"/> </InvoiceDetailRequestHeader>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 341

Page 342: 355a de soluciones cXML - help.sap.com

Extrínsecos para información adicional para condiciones de pago

Ariba Network proporciona varios extrínsecos relacionados con la información de las condiciones de pago en facturas.

El elemento InvoiceDetailRequestHeader puede contener los siguientes elementos extrínsecos cXML para especificar información adicional para condiciones de pago:

Nombre extrínseco Descripción

discountInformation Información no estructurada relacionada con los descuentos.

penaltyInformation Información no estructurada relacionada con las penalizaciones.

netTermInformation Información no estructurada relacionada con la condición de pago neto.

El extracto cXML siguiente muestra los elementos extrínsecos:

<Extrinsic name="discountInformation">No discounts are applied</Extrinsic> <Extrinsic name="penaltyInformation">No penalties are applied</Extrinsic> <Extrinsic name="netTermInformation">No net term is defined</Extrinsic>

Extrínseco para hacer referencia a una propuesta de pago

Los compradores pueden enviar una PaymentRemittanceRequest a un proveedor para las facturas que no existen en el sistema de compras. Todos los detalles de envío de un pago específico que ha sido pagado pueden hacer referencia a una propuesta de pago utilizando un elemento extrínseco denominado PaymentProposalID, tal y como se muestra en el siguiente ejemplo cXML.

<RemittanceDetail lineNumber="1"> <PayableInfo> <PayableInvoiceInfo> <InvoiceIDInfo invoiceID="INV-skm-0504-1" invoiceDate="2011-05-04T04:22:23-07:00"/> <PayableOrderInfo> <OrderIDInfo orderID="PO-skm-0504-1"/> </PayableOrderInfo> </PayableInvoiceInfo> </PayableInfo> <NetAmount> <Money currency="USD">1039.90</Money> </NetAmount> <GrossAmount> <Money currency="USD">1039.90</Money> </GrossAmount> <DiscountAmount> <Money currency="USD">0</Money> </DiscountAmount> <AdjustmentAmount> <Money currency="USD">0</Money> </AdjustmentAmount> <Extrinsic name="PaymentProposalID">PPR-skm-0504-1</Extrinsic> </RemittanceDetail>

342PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 343: 355a de soluciones cXML - help.sap.com

Extrínsecos para campos específicos de país en la cabecera de la factura

Este tema muestra cómo los campos específicos del país de los perfiles del comprador y del proveedor se asignan a elementos cXML o elementos extrínsecos.

Campo Extrínseco XPath

Número de registro de GST del proveedor

N/A InvoiceDetailRequestHeader/InvoicePartner/Contact[@role='from']/IdReference domain gstID

Número de registro de GST del comprador

N/A InvoiceDetailRequestHeader/InvoicePartner/Contact[@role='soldTo']/IdReference domain gstID

Número de registro de PST del proveedor

N/A InvoiceDetailRequestHeader/InvoicePartner/Contact[@role='from']/IdReference domain provincialTaxID

Número de registro de PST del comprador

N/A InvoiceDetailRequestHeader/InvoicePartner/Contact[@role='soldTo']/IdReference domain provincialTaxID

Número de registro de QST del proveedor

N/A InvoiceDetailRequestHeader/InvoicePartner/Contact[@role='from']/IdReference domain qstId

Número de registro de QST del comprador

N/A InvoiceDetailRequestHeader/InvoicePartner/Contact[@role='soldTo']/IdReference domain qstId

Formulario legal del proveedor

LegalStatus InvoiceDetailRequestHeader/InvoicePartner/Contact[@role='from']/ Extrinsic[@name='LegalStatus']

Número de registro del proveedor

supplierCommercialIdentifier

InvoiceDetailRequestHeader/Extrinsic[@name='supplierCommercialIdentifier']

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 343

Page 344: 355a de soluciones cXML - help.sap.com

Campo Extrínseco XPath

Juzgado de registro comercial del proveedor

commercialRegisterCourt InvoiceDetailRequestHeader/Extrinsic[@name=' supplierCommercialRegisterCourt']

Penalización de pago atrasado del proveedor

penaltyInformation InvoiceDetailRequestHeader/Extrinsic[@name=' penaltyInformation']

Capital de la empresa del proveedor

LegalCapital InvoiceDetailRequestHeader/Extrinsic[@name='LegalCapital']

Condiciones de descuentos de proveedor

discountInformation InvoiceDetailRequestHeader/Extrinsic[@name='discountInformation']

Extrínsecos para facturas de autofacturación

Ariba Network puede transmitir automáticamente facturas de autofacturación a los proveedores y compradores en función de los datos en los pedidos de compra, órdenes de entrega y recepción de bienes mediante un proceso automático llamado Evaluated Receipt Settlement (ERS). El comprador crea una factura de autofacturación en un sistema de empresa externo y la envía al proveedor mediante Ariba Network. Si corresponde, el Ariba Network agrega firmas específicas de país al documento de autofacturación cXML a partir de la ubicación del proveedor (país)

Los siguientes elementos extrínsecos de InvoiceDetailRequestHeader indican si una factura es de autofacturación:

Extrínseco Descripción

ERS Indica si una factura es una factura de autofacturación. El valor varía según el país.

Statements Proporciona información adicional para la autoridad fiscal para cumplir los requisitos lega­les para la autofacturación en dicho país.

El ejemplo siguiente muestra los extrínsecos de autofacturación:

<InvoiceDetailRequestHeader> ... <Extrinsic name="ERS">Self-Billing</Extrinsic> <Extrinsic name="Statements">The VAT shown is your output tax due to HMRC.</Extrinsic> ... </InvoiceDetailRequestHeader>

344PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 345: 355a de soluciones cXML - help.sap.com

Longitudes de campo del elemento de factura

Los elementos de factura tienen longitudes de campo máximas. Téngalas en cuenta al crear facturas.

Las longitudes de campo para los elementos y los atributos de factura son las siguientes:

Elemento o atributo Descripción de campo

Atributo invoiceDate Formato de fecha y hora fijo, como por ejemplo: 2004-01-23T00:55:14-04:00

Atributo invoiceID 128 caracteres

Atributo invoiceLineNumber <2.000.000.000

Elemento Name 256 caracteres

Elemento Street 256 caracteres

Elemento City 256 caracteres

Elemento State 256 caracteres

Elemento PostalCode 256 caracteres

Elemento Country 256 caracteres

Atributo isoCountryCode 2 caracteres

Atributo agreementID 128 caracteres

Atributo orderID 128 caracteres

Atributo orderDate Formato de fecha y hora fijo, como por ejemplo: 2004-01-23T00:55:14-04:00

Atributo quantity precisión 30, escala 15 (30, 15)

Elemento UnitOfMeasure 24 caracteres

Atributo currency 3 caracteres

Elemento Money (30, 15)

Atributo lineNumber <2.000.000.000

Elemento SupplierPartID 256 caracteres

Elemento Description 1000 caracteres

Elemento ShortName 256 caracteres

Atributo percentageRate (10, 5)

Adjuntos de copia de la factura en PDF

En muchos casos, los gestores de excepciones de facturas o el personal encargado de las cuentas por pagar requieren un formato representado de los datos de factura que represente la vista del proveedor de la factura en Ariba Network.

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 345

Page 346: 355a de soluciones cXML - help.sap.com

Si su cuenta está habilitada para adjuntos de copia de factura en PDF, Ariba Network genera una copia de factura en PDF para todas las facturas y la agrega a la factura cXML como adjunto MIME de la forma siguiente:

<InvoiceDetailRequestHeader> Extrinsic name="invoicePDF"> <Attachment> <URL>cid:[email protected]</URL> </Attachment> </Extrinsic> </InvoiceDetailRequestHeader>

Las copias de factura PDF se generan para los siguientes tipos de factura enviados por el proveedor:

● Las facturas enviadas mediante EDI o cXML que no están autofirmadas por el proveedor● Facturas basadas en pedido o sin pedido que se han creado manualmente● Facturas creadas con una importación CSV

Las copias en PDF de facturas no se generan para las siguientes facturas:

● Facturas del Servicio de conversión de facturas (ICS)● Facturas de proveedor autofirmadas

Para estas facturas, se espera que el proveedor incluya una copia de la factura en PDF como un adjunto de la factura, si es necesario.

El nombre de archivo del adjunto de copia de factura en PDF es un nombre de archivo aleatorio, por ejemplo: kBAIGmcwmN502a7638191182029.pdf.

Transmisión de facturas a organizaciones de comprasAriba Buyer utiliza la misma transacción GetPending para obtener documentos InvoiceDetailRequest de la misma manera que hace para la otra comunicación con Ariba Network. Ariba Buyer determina el intervalo de consulta.

Ariba Network permite orientar las facturas sólo para organizaciones compradoras que hayan habilitado sus cuentas de Ariba Network para la facturación.

Información relacionada

Reglas de negocio de facturación [página 287]

Estado y cancelación de facturasLas organizaciones compradoras pueden fijar estados de las facturas. Los proveedores pueden cancelar facturas.

346PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 347: 355a de soluciones cXML - help.sap.com

Estado de factura

Las organizaciones compradoras envían documentos StatusUpdateRequest para establecer estados de factura.

En la siguiente tabla se enumeran las configuraciones de estado de factura válidas y lo que significan.

Estado de factura Descripción

Procesando La organización compradora ha recibido la factura y se está llevando a cabo la reconciliación.

Cancelado La organización compradora ha recibido la factura y se ha cancelado.

Reconciliado (También denominado "Aprobado") Todos los importes de la factura coinciden con los del pe­dido de compra o contrato.

En proceso de pago La factura está en proceso de pago o se ha pagado parcialmente. Este estado sólo se aplica si la organización compradora utiliza facturas para iniciar el pago.

Pagado La factura se ha pagado. Este estado sólo se aplica si la organización compradora utiliza factu­ras para iniciar el pago.

Rechazado La organización compradora ha recibido la factura y se ha rechazado.

Los proveedores habilitados para cXML pueden recibir estos documentos. Ariba Network publica estos documentos en la URL que los proveedores devuelven a su cXML ProfileResponse. Después de que una organización compradora reconcilie una factura, los proveedores no pueden modificarla o cancelarla. Los proveedores no pueden facturar contra pedidos de compra cancelados.

Los documentos StatusUpdateRequest pueden identificar facturas de dos formas distintas: mediante un elemento DocumentReference o InvoiceIDInfo. Las organizaciones compradoras utilizan una DocumentReference si conocen el payloadID de la factura, y deben usar un elemento InvoiceIDInfo si conocen el invoiceID y la invoiceDate de la factura.

Cancelación de facturas

Los proveedores pueden cancelar las facturas que no tengan el estado de factura "reconciliada", "en proceso de pago" o "pagada". Cancelan las facturas emitiendo una factura con InvoiceDetailRequestHeader operation="delete". Ariba Network establece el estado del documento en "obsoleto". Los proveedores no pueden cancelar una factura que ya se haya cancelado.

Ariba Buyer descarga facturas canceladas, pero no distingue entre las facturas nuevas y las canceladas. Sigue funcionando en la factura original. Envía actualizaciones de estado de factura para facturas "obsoletas", pero no para facturas que se deban cancelar (facturas con InvoiceDetailRequestHeader operation="delete"). Es decir, si la factura B cancela la factura A, Ariba Buyer envía actualizaciones de estado de factura para la factura A, no para la factura B. Algunos clientes modifican Ariba Buyer para procesar de forma diferente las facturas de cancelación; los proveedores deben consultar con los clientes para ver cómo se tratan estas facturas.

SAP Ariba Buying and Invoicing descarga facturas canceladas, las evalúa y envía un documento StatusUpdateRequest a Ariba Network. Mientras SAP Ariba Buying and Invoicing evalúa las facturas canceladas, Ariba Network establece el estado del documento en "cancelando". Si SAP Ariba Buying and Invoicing las aprueba, Ariba Network establece el estado del documento en "cancelado". Si SAP Ariba Buying and Invoicing las rechaza, Ariba Network establece el estado del documento de nuevo a su estado original.

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 347

Page 348: 355a de soluciones cXML - help.sap.com

Ejemplo de factura de resumen (varios pedidos de compra)En el ejemplo de factura de resumen se ilustra una factura de resumen contra dos pedidos de compra diferentes. Las facturas de resumen también se denominan facturas de varios pedidos de compra o consolidadas.

La factura de resumen contiene atributos payloadID en el nivel de artículo en línea, que hace referencia al payloadID de los dos documentos originales OrderRequest. El atributo invoiceLineNumber hace referencia al número de artículo en línea en la factura. El atributo lineNumber hace referencia al número de artículo en línea en la OrderRequest original.

NotaCon las facturas de mano de obra contratada, Ariba Network muestra cada artículo en línea de la factura en el resumen.

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/InvoiceDetail.dtd"><cXML payloadID="125multi-supplierxyzkjlkwxxx-nju" timestamp="2001-04-20T23:59:45-07:00"> <Header> <From> <Credential domain="NetworkID"> <Identity>AN0100001234</Identity> </Credential> </From> <To> <Credential domain="NetworkID"> <Identity>AN01000006789</Identity> </Credential> </To> <Sender> <Credential domain="DUNS"> <Identity>556376197</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>cXML V1.2 application</UserAgent> </Sender> </Header> <Request > <InvoiceDetailRequest> <InvoiceDetailRequestHeader invoiceDate="2001-12-07T00:00:00-07:00" invoiceID="MULTIINV1" purpose="standard" operation="new"> <InvoiceDetailHeaderIndicator></InvoiceDetailHeaderIndicator> <InvoiceDetailLineIndicator isTaxInLine="yes" isShippingInLine="yes" isAccountingInLine="yes"> </InvoiceDetailLineIndicator> <InvoicePartner> <Contact role="soldTo" addressID="B2.4.353"> <Name xml:lang="en">Buyer 1</Name> <PostalAddress name="default"> <DeliverTo>Buyer 1</DeliverTo> <Street>15 Camino del Cerro</Street> <City>Los Gatos</City> <State>CA</State> <PostalCode>95032</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> <Email name="default">[email protected]</Email> <Phone name="work"> <TelephoneNumber>

348PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 349: 355a de soluciones cXML - help.sap.com

<CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode>408</AreaOrCityCode> <Number>3582000</Number> </TelephoneNumber> </Phone> <Fax name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode>408</AreaOrCityCode> <Number>3582100</Number> </TelephoneNumber> </Fax> </Contact> </InvoicePartner> <InvoicePartner> <Contact role="remitTo" addressID="Billing"> <Name xml:lang="en">Joan Bill</Name> <PostalAddress name="billing department"> <DeliverTo>Joan Bill</DeliverTo> <Street>16 Castro Street</Street> <City>Mountain View</City> <State>CA</State> <PostalCode>95035</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> <Email name="default">[email protected]</Email> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode>650</AreaOrCityCode> <Number>9990000</Number> </TelephoneNumber> </Phone> </Contact> <IdReference identifier="011" domain="accountReceivableID"> <Creator xml:lang="en">Supplier ERP</Creator> </IdReference> <IdReference identifier="123456789" domain="bankRoutingID"> <Creator xml:lang="en">Supplier Bank</Creator> </IdReference> </InvoicePartner> <PaymentTerm payInNumberOfDays="20"> <Discount>5</Discount> </PaymentTerm> <PaymentTerm payInNumberOfDays="30"> <Discount>2.5</Discount> </PaymentTerm> <PaymentTerm payInNumberOfDays="40"> <Discount>-2</Discount> </PaymentTerm> </InvoiceDetailRequestHeader> <InvoiceDetailOrder> <InvoiceDetailOrderInfo> <OrderReference orderID="PO123"> <DocumentReference payloadID="[email protected]"> </DocumentReference> </OrderReference> </InvoiceDetailOrderInfo> <InvoiceDetailItem invoiceLineNumber="1" quantity="5"> <UnitOfMeasure>EA</UnitOfMeasure> <UnitPrice> <Money currency="USD">10.00</Money> </UnitPrice> <InvoiceDetailItemReference lineNumber="1"> <ItemID> <SupplierPartID>A2</SupplierPartID> </ItemID>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 349

Page 350: 355a de soluciones cXML - help.sap.com

<Description xml:lang="en">Cabinet Locks with 2 Keys </Description> <SerialNumber>45993823469876</SerialNumber> <SerialNumber>45993823469877</SerialNumber> <SerialNumber>45993823469878</SerialNumber> <SerialNumber>45993823469879</SerialNumber> <SerialNumber>45993823469880</SerialNumber> </InvoiceDetailItemReference> <SubtotalAmount> <Money currency="USD">50.00</Money> </SubtotalAmount> <GrossAmount> <Money currency="USD">50.00</Money> </GrossAmount> <NetAmount> <Money currency="USD">50.00</Money> </NetAmount> <Distribution> <Accounting name="DistributionCharge"> <AccountingSegment id="100" <Name xml:lang="en-US">Split Percentage</Name> <Description xml:lang="en-US">Percentage </Description> </AccountingSegment> <AccountingSegment id="Machine Resources" <Name xml:lang="en-US">Cost Center</Name> Description xml:lang="en-US">Department Name </Description> </AccountingSegment> <AccountingSegment id="Office Supplies" <Name xml:lang="en-US">Account</Name> <Description xml:lang="en-US">Account Name </Description> </AccountingSegment> </Accounting> <Charge> <Money currency="USD">50.00</Money> </Charge> </Distribution> </InvoiceDetailItem> </InvoiceDetailOrder> <InvoiceDetailOrder> <InvoiceDetailOrderInfo> <OrderReference orderID="PO123"> <DocumentReference payloadID="[email protected]"> </DocumentReference> </OrderReference> </InvoiceDetailOrderInfo> <InvoiceDetailItem invoiceLineNumber="2" quantity="10"> <UnitOfMeasure>EA</UnitOfMeasure> <UnitPrice> <Money currency="USD">1.00</Money> </UnitPrice> <InvoiceDetailItemReference lineNumber="3"> <ItemID><SupplierPartID>A4</SupplierPartID></ItemID> <Description xml:lang="en">Cam Locks without Keys </Description> <ManufacturerPartID>815-12</ManufacturerPartID> <ManufacturerName xml:lang="en-US"></ManufacturerName> </InvoiceDetailItemReference> <SubtotalAmount> <Money currency="USD">10.00</Money> </SubtotalAmount> <GrossAmount> <Money currency="USD">10.00</Money> </GrossAmount> <NetAmount> <Money currency="USD">10.00</Money>

350PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 351: 355a de soluciones cXML - help.sap.com

</NetAmount> <Distribution> <Accounting name="DistributionCharge"> <AccountingSegment id="100"> <Name xml:lang="en-US">Split Percentage</Name> <Description xml:lang="en-US">Percentage </Description> </AccountingSegment> <AccountingSegment id="Machine Resources"> <Name xml:lang="en-US">Cost Center</Name> <Description xml:lang="en-US">Department Name </Description> </AccountingSegment> </Accounting> <Charge><Money currency="USD">10.00</Money></Charge> </Distribution> </InvoiceDetailItem> </InvoiceDetailOrder> <InvoiceDetailSummary> <SubtotalAmount> <Money currency="USD">60.00</Money> </SubtotalAmount> <Tax> <Money currency="USD">60.00</Money> <Description xml:lang="en-US">Sales Tax</Description> </Tax> <GrossAmount> <Money currency="USD">60.00</Money> </GrossAmount> <NetAmount> <Money currency="USD">60.00</Money> </NetAmount> <DueAmount>< Money currency="USD">60.00</Money> </DueAmount> </InvoiceDetailSummary> </InvoiceDetailRequest> </Request> </cXML>

Factura de nivel de cabecera de ejemploSi los proveedores facturan pedidos de compra completos, no es necesario proporcionar información detallada del artículo en línea; es suficiente con presentar una factura de nivel de cabecera.

El atributo isHeaderInvoice está fijado en "yes" para indicar que la factura es del tipo Cabecera.

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/InvoiceDetail.dtd"><cXML timestamp="2001-12-07T16:23:01-07:00" payloadID="Oct102001_0447pm98788688"> <Header> <From> <Credential domain="NetworkID"> <Identity>AN0100001234</Identity> </Credential> </From> <To> <Credential domain="NetworkID"> <Identity>AN01000004321</Identity> </Credential> </To>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 351

Page 352: 355a de soluciones cXML - help.sap.com

<Sender> <Credential domain="DUNS"> <Identity>556376197</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>cXML V1.2 application</UserAgent> </Sender> </Header> <Request> <InvoiceDetailRequest> <InvoiceDetailRequestHeader invoiceDate="2001-12-07T00:00:00-07:00" invoiceID="HEADERINV222" purpose="standard" operation="new"> InvoiceDetailHeaderIndicator isHeaderInvoice="yes"> </InvoiceDetailHeaderIndicator> <InvoiceDetailLineIndicator isTaxInLine="yes" isShippingInLine="yes"/> <InvoicePartner> <Contact role="billTo"> <Name xml:lang="en-US">Buyer Headquarters</Name> <PostalAddress> <Street>123 Main Street</Street> <City>Anytown</City> <State>TX</State> <PostalCode>99999</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> </Contact> </InvoicePartner> <InvoicePartner> <Contact role="remitTo"> <Name xml:lang="en-US">Joan Bill</Name> <PostalAddress> <Street>One Test Avenue</Street> <City>Sunnyvale</City> <State>CA</State> <PostalCode>94087</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> </Contact> <IdReference identifier="StandardHeaderLevelIndividual" domain="accountID"></IdReference> </InvoicePartner> <Comments xml:lang="en-US">Sample Header Level Individual Invoice</Comments> </InvoiceDetailRequestHeader> <InvoiceDetailHeaderOrder> <InvoiceDetailOrderInfo> <OrderIDInfo orderID="DO21756" orderDate=""2007-07-01T09:42:30-05:00""> </OrderIDInfo> </InvoiceDetailOrderInfo> <InvoiceDetailOrderSummary invoiceLineNumber="1"> <SubtotalAmount> <Money currency="USD">20.00</Money> </SubtotalAmount> <Tax> <Money currency="USD">5.00</Money> <Description xml:lang="en-US"></Description> </Tax> <InvoiceDetailLineSpecialHandling> <Money currency="USD">10.00</Money> </InvoiceDetailLineSpecialHandling> <InvoiceDetailLineShipping> <InvoiceDetailShipping> <Contact role="shipFrom" addressID="1000487"> <Name xml:lang="en">Main Shipping</Name> <PostalAddress name="default"> <Street>15 Camino del Cerro</Street>

352PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 353: 355a de soluciones cXML - help.sap.com

<City>Los Gatos</City> <State>CA</State> <PostalCode>95032</PostalCode> <Country isoCountryCode="US">United States </Country> </PostalAddress> <Email name="default">[email protected]</Email> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1 </CountryCode> <AreaOrCityCode>408</AreaOrCityCode> <Number>3582000</Number> </TelephoneNumber> </Phone> <Fax name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1 </CountryCode> <AreaOrCityCode>408</AreaOrCityCode> <Number>3582100</Number> </TelephoneNumber> </Fax> </Contact> <Contact role="shipTo" addressID="1000487"> <Name xml:lang="en">Buyer Headquarters</Name> <PostalAddress name="default"> <DeliverTo>Jason Lynch</DeliverTo> <Street>34 Castro Street</Street> <City>Mountain View</City> <State>CA</State> <PostalCode>95035</PostalCode> <Country isoCountryCode="US">United States </Country> </PostalAddress> <Email name="default">[email protected]</Email> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1 </CountryCode> <AreaOrCityCode>408</AreaOrCityCode> <Number>3582000</Number> </TelephoneNumber> </Phone> <Fax name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1 </CountryCode> <AreaOrCityCode>408</AreaOrCityCode> <Number>3582100</Number> </TelephoneNumber> </Fax> </Contact> </InvoiceDetailShipping> <Money currency="USD">20</Money> </InvoiceDetailLineShipping> <GrossAmount> <Money currency="USD">35.00</Money> </GrossAmount> <InvoiceDetailDiscount percentageRate="10%"> <Money currency="USD">2.00</Money> </InvoiceDetailDiscount> <NetAmount><Money currency="USD">33.00</Money></NetAmount> <Comments>This a Standard Header Level Invoice</Comments> </InvoiceDetailOrderSummary> </InvoiceDetailHeaderOrder> <InvoiceDetailSummary> <SubtotalAmount>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 353

Page 354: 355a de soluciones cXML - help.sap.com

<Money currency="USD">20.00</Money> </SubtotalAmount> <Tax> <Money currency="USD">5.00</Money> <Description xml:lang="en-US"></Description> </Tax> <SpecialHandlingAmount> <Money currency="USD">10.00</Money> </SpecialHandlingAmount> <ShippingAmount> <Money currency="USD">5.00</Money> </ShippingAmount> <GrossAmount><Money currency="USD">40.00</Money></GrossAmount> <InvoiceDetailDiscount percentageRate="10%"> <Money currency="USD">18.00</Money> </InvoiceDetailDiscount> <NetAmount><Money currency="USD">18.00</Money></NetAmount> <DepositAmount> <Money currency="USD">33.00</Money> </DepositAmount> <DueAmount> <Money currency="USD">33.00</Money> </DueAmount> </InvoiceDetailSummary> </InvoiceDetailRequest> </Request> </cXML>

Factura de pedido de compra global de ejemploLa factura de pedido de compra global de ejemplo ilustra una factura para un pedido de compra global no preferente (no es necesario un pedido de compra antes de la facturación).

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://svcdev.ariba.com/schemas/cXML/1.2.018/InvoiceDetail.dtd"><cXML payloadID="INV011-Against-BPO55@payload" timestamp="2007-08-20T08:49:36-07:00"> <Header> <From> <Credential domain="AribaNetworkUserId"> <Identity>AN0100001234</Identity> </Credential> </From> <To> <Credential domain="AribaNetworkUserId"> <Identity>AN01000006789</Identity> </Credential> </To> <Sender> <Credential domain="DUNS"> <Identity>556376197</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Ariba Network V1.1</UserAgent> </Sender> </Header> <Request deploymentMode="production"> <InvoiceDetailRequest> <InvoiceDetailRequestHeader invoiceDate="2007-08-20T08:49:36-07:00" invoiceID="INV011-Against-BPO55" operation="new"

354PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 355: 355a de soluciones cXML - help.sap.com

purpose="standard"> <InvoiceDetailHeaderIndicator></InvoiceDetailHeaderIndicator> <InvoiceDetailLineIndicator></InvoiceDetailLineIndicator> <InvoicePartner> <Contact role="remitTo"> <Name xml:lang="en-US">SUPPLIER</Name> <PostalAddress> <Street>jUnitDummy</Street> <City>Sunnyvale</City> <State>CA</State> <PostalCode>94089</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> </Contact> </InvoicePartner> <InvoicePartner> <Contact role="soldTo"> <Name xml:lang="en-US">BUYER</Name> <PostalAddress> <Street>jUnitDummy</Street> <City>Sunnyvale</City> <State>CA</State> <PostalCode>94089</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> </Contact> </InvoicePartner> <InvoicePartner> <Contact role="billTo"> <Name xml:lang="en-US"></Name> </Contact> </InvoicePartner> <InvoicePartner> <Contact role="from"> <Name xml:lang="en-US">SUPPLIER</Name> <PostalAddress> <Street>jUnitDummy</Street> <City></City> <State>CA</State> <Country isoCountryCode="US">United States</Country> </PostalAddress> </Contact> </InvoicePartner> <InvoiceDetailShipping> <Contact role="shipTo"> <Name xml:lang="en-US">BUYER</Name> <PostalAddress> <Street>jUnitDummy</Street> <City>Sunnyvale</City> <State>CA</State> <PostalCode>94089</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> </Contact> <Contact role="shipFrom"> <Name xml:lang="en-US">SUPPLIER</Name> <PostalAddress> <Street>jUnitDummy</Street> <City>Sunnyvale</City> <State>CA</State> <PostalCode>94089</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> </Contact> </InvoiceDetailShipping> </InvoiceDetailRequestHeader> <InvoiceDetailOrder> <InvoiceDetailOrderInfo>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 355

Page 356: 355a de soluciones cXML - help.sap.com

<OrderReference orderID="BPO55"> <DocumentReference payloadID="BPO55@payloadID"> </DocumentReference> </OrderReference> </InvoiceDetailOrderInfo> <InvoiceDetailItem invoiceLineNumber="1" quantity="1"> <UnitOfMeasure>EA</UnitOfMeasure> <UnitPrice> <Money currency="USD">44.00</Money> </UnitPrice> <InvoiceDetailItemReference lineNumber="1"> <ItemID><SupplierPartID>AD4BNC13</SupplierPartID></ItemID> <Description xml:lang="en">Adapter SUN Monitor 4-BNCF/13W3M </Description> </InvoiceDetailItemReference> <SubtotalAmount> <Money currency="USD">44.00</Money> </SubtotalAmount> <GrossAmount> <Money currency="USD">44.00</Money> </GrossAmount> <NetAmount> <Money currency="USD">44.00</Money> </NetAmount> </InvoiceDetailItem> <InvoiceDetailItem invoiceLineNumber="2" quantity="1"> <UnitOfMeasure>EA</UnitOfMeasure> <UnitPrice> <Money currency="USD">34.00</Money> </UnitPrice> <InvoiceDetailItemReference lineNumber="2"> <ItemID><SupplierPartID>AD1513</SupplierPartID></ItemID> <Description xml:lang="en">Adapter SUN Monitor HD15F/13W3M </Description> </InvoiceDetailItemReference> <SubtotalAmount> <Money currency="USD">34.00</Money> </SubtotalAmount> <GrossAmount> <Money currency="USD">34.00</Money> </GrossAmount> <NetAmount> <Money currency="USD">34.00</Money> </NetAmount> </InvoiceDetailItem> </InvoiceDetailOrder> <InvoiceDetailSummary> <SubtotalAmount> <Money currency="USD">78.00</Money> </SubtotalAmount> <Tax> <Money currency="USD">10.00</Money> <Description xml:lang="en-US"></Description> </Tax> <GrossAmount> <Money currency="USD">78.00</Money> </GrossAmount> <NetAmount> <Money currency="USD">78.00</Money> </NetAmount> <DueAmount> <Money currency="USD">78.00</Money> </DueAmount> </InvoiceDetailSummary> </InvoiceDetailRequest> </Request> </cXML>

356PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 357: 355a de soluciones cXML - help.sap.com

Para un pedido de compra global preferente (requiere pedidos de compra antes de la facturación), el elemento OrderRequestHeader está presente, y el orderType es blanket, tal y como se muestra en el ejemplo siguiente:

<OrderRequest> <OrderRequestHeader orderID="DO12042" orderDate="2008-12-04T15:26:00-07:00" type="new" orderType="blanket"> </OrderRequestHeader> <OrderRequest>

Ejemplo de un escenario comprador/proveedor complejoLos documentos de ejemplo del escenario comprador/proveedor complejo ilustran un pedido de compra de comprador, una factura estándar, un abono y una nota de débito.

Los siguientes documentos cXML describen un escenario empresarial complejo

1. Ariba Buyer genera un pedido de compra que contiene dos artículos en línea:○ Línea 1: Diez artículos a 20€ = 200€○ Línea 2: Cinco artículos a 20€ = 100€

2. El proveedor envía una factura estándar que incluye cargos de expedición, pero carga erróneamente a la organización compradora ocho artículos en la línea 2 en lugar de cinco.

3. El proveedor envía un abono de 110€, que incluye cargos impositivos.4. El proveedor se da cuenta de que se ha equivocado en el abono; debería haber cobrado 66€ a la organización

compradora. A continuación, el proveedor envía una nota de débito de 44€ (110€ - 66€).

Ejemplo de pedido de compra: Escenario comprador/proveedor complejo

El pedido de compra de ejemplo contiene dos artículos en línea.

● Línea 1: Diez artículos a 20€ = 200€● Línea 2: Cinco artículos a 20€ = 100€

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd"><cXML payloadID="[email protected]" timestamp="2001-12-04T15:26:00-07:00"> <Header> <From> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> </Credential> </From> <To> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> </Credential> </To> <Sender>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 357

Page 358: 355a de soluciones cXML - help.sap.com

<Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> <SharedSecret>OurPassword</SharedSecret> </Credential> <UserAgent>Ariba Buyer 7.0</UserAgent> </Sender> </Header> <Request> <OrderRequest> <OrderRequestHeader orderID="DO12042" orderDate="2001-12-04T15:26:00-07:00" type="new" orderType="regular"> <Total> <Money currency="USD">300.00</Money> </Total> <ShipTo> <Address isoCountryCode="US" addressID="1000467"> <Name xml:lang="en">Bigcompany Headquarters</Name> <PostalAddress name="default"> <DeliverTo>Betty Buyer</DeliverTo> <DeliverTo>Bigcompany Headquarters</DeliverTo> <Street>1314 Chesapeake Terrace</Street> <City>Sunnyvale</City> <State>CA</State> <PostalCode>94089</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> <Email name="default">[email protected]</Email> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode>800</AreaOrCityCode> <Number>5555555</Number> </TelephoneNumber> </Phone> <Fax name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode></AreaOrCityCode> <Number></Number> </TelephoneNumber> </Fax> </Address> </ShipTo> <BillTo> <Address isoCountryCode="US" addressID="15"> <Name xml:lang="en">Bigcompany Headquarters</Name> <PostalAddress name="Accounts Payable"> <Street>1314 Chesapeake Terrace</Street> <City>Sunnyvale</City> <State>CA</State> <PostalCode>94089</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode></AreaOrCityCode> <Number></Number> </TelephoneNumber> </Phone> <Fax name="work"> <TelephoneNumber> CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode></AreaOrCityCode> <Number></Number> </TelephoneNumber> </Fax>

358PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 359: 355a de soluciones cXML - help.sap.com

</Address> </BillTo> </OrderRequestHeader> <ItemOut quantity="10" lineNumber="1"> <ItemID> <SupplierPartID>BTM00107</SupplierPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">20.00</Money> </UnitPrice> <Description xml:lang="en">Computer Audio Cables</Description> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="UNSPSC">43173609</Classification> <ManufacturerPartID>JJ11P28</ManufacturerPartID> <Extrinsic name="PR No.">PR1026</Extrinsic> </ItemDetail> <Distribution> <Accounting name="DistributionCharge"> <AccountingSegment id="Production Control" <Name xml:lang="en-US">Cost Center</Name> <Description xml:lang="en-US"> Department Name </Description> </AccountingSegment> <AccountingSegment id="Computer Accessories" <Name xml:lang="en-US">Account</Name> <Description xml:lang="en-US"> Account Name </Description> </AccountingSegment> </Accounting> <Charge> <Money currency="USD">200.00</Money> </Charge> </Distribution> </ItemOut> <ItemOut quantity="5" lineNumber="2"> <ItemID> <SupplierPartID>BTM00108</SupplierPartID> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">20.00</Money> </UnitPrice> <Description xml:lang="en">Computer Video Cables</Description> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="UNSPSC">43173610</Classification> <ManufacturerPartID>JJ11P29</ManufacturerPartID> <Extrinsic name="PR No.">PR1026</Extrinsic> </ItemDetail> <Distribution> <Accounting name="DistributionCharge"> <AccountingSegment id="Production Control" <Name xml:lang="en-US">Cost Center</Name> <Description xml:lang="en-US"> Department Name </Description> </AccountingSegment> <AccountingSegment id="Computer Accessories" <Name xml:lang="en-US">Account</Name> <Description xml:lang="en-US"> Account Name </Description> </AccountingSegment> </Accounting> <Charge> <Money currency="USD">100.00</Money> </Charge> </Distribution> </ItemOut> </OrderRequest>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 359

Page 360: 355a de soluciones cXML - help.sap.com

</Request> </cXML>

Ejemplo de factura estándar: Escenario comprador/proveedor complejoEn el ejemplo, la factura estándar incluye cargos de expedición, pero carga erróneamente a la organización compradora ocho artículos en lugar de cinco en la línea 2.

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cXML.org/schemas/cXML/1.2.014/InvoiceDetail.dtd"><cXML payloadID="INVDO12042.120402" timestamp="2001-12-04T17:30:00-07:00"> <Header> <From> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> </Credential> </From> <To> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> </Credential> </To> <Sender> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Our Invoicing App 2.0</UserAgent> </Sender> </Header> <Request> <InvoiceDetailRequest> <InvoiceDetailRequestHeader invoiceID="InvDO12042" purpose="standard" operation="new" invoiceDate="2001-12-04T17:30:00-07:00"> <InvoiceDetailHeaderIndicator></InvoiceDetailHeaderIndicator> <InvoiceDetailLineIndicator isTaxInLine="yes" isShippingInLine="yes" isAccountingInLine="yes"> </InvoiceDetailLineIndicator> <InvoicePartner> <Contact role="billTo" addressID="Billing"> <Name xml:lang="en">Bigcompany Headquarters</Name> <PostalAddress name="Accounts Payable"> <DeliverTo>Joe Accountant</DeliverTo> <Street>1314 Chesapeake Terrace</Street> <City>Sunnayvale</City> <State>CA</State> <PostalCode>94089</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> <Email name="default">[email protected] </Email> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode>215</AreaOrCityCode> <Number>9990000</Number> </TelephoneNumber> </Phone> </Contact> <IdReference identifier="11280630" domain="accountReceivableID"> <Creator xml:lang="en">Acme</Creator>

360PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 361: 355a de soluciones cXML - help.sap.com

</IdReference> </InvoicePartner> </InvoiceDetailRequestHeader> <InvoiceDetailOrder> <InvoiceDetailOrderInfo> <OrderReference orderID="PO123"> <DocumentReference payloadID = "[email protected]"> </DocumentReference> </OrderReference> </InvoiceDetailOrderInfo> <InvoiceDetailItem invoiceLineNumber="1" quantity="4"> <UnitOfMeasure>EA</UnitOfMeasure> <UnitPrice> <Money currency="USD">50.00</Money> </UnitPrice> <InvoiceDetailItemReference lineNumber="1"> <ItemID> <SupplierPartID>BTM00107</SupplierPartID> </ItemID> <Description xml:lang="en">Computer Audio Cables </Description> <SerialNumber>69876</SerialNumber> <SerialNumber>69877</SerialNumber> <SerialNumber>69878</SerialNumber> <SerialNumber>69879</SerialNumber> </InvoiceDetailItemReference> <SubtotalAmount> <Money currency="USD">200.00</Money> </SubtotalAmount> <InvoiceDetailLineShipping> <InvoiceDetailShipping> <Contact role="shipFrom" addressID="1000467"> <Name xml:lang="en">Acme</Name> <PostalAddress name="Acme"> <Street>123 Main Street</Street> <City>Anytown</City> <State>PA</State> <PostalCode>99999</PostalCode> <Country isoCountryCode="US"> United States</Country> </PostalAddress> <Email name="default">[email protected]</Email> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1 </CountryCode> <AreaOrCityCode>800</AreaOrCityCode> <Number>5555555</Number> </TelephoneNumber> </Phone> <Fax name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1 </CountryCode> AreaOrCityCode></AreaOrCityCode> <Number></Number> </TelephoneNumber> </Fax> </Contact> <Contact role="shipTo" addressID="1000487"> <Name xml:lang="en">Betty Buyer</Name> <PostalAddress name="default"> <DeliverTo>Betty Buyer</DeliverTo> <Street>1314 Chesapeake Terrace</Street> <City>Sunnyvale</City> <State>CA</State> <PostalCode>94089</PostalCode>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 361

Page 362: 355a de soluciones cXML - help.sap.com

<Country isoCountryCode="US"> United States</Country> </PostalAddress> <Email name="default">[email protected] </Email> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1 </CountryCode> <AreaOrCityCode>800</AreaOrCityCode> <Number>6666666</Number> </TelephoneNumber> </Phone> <Fax name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1 </CountryCode> <AreaOrCityCode>215</AreaOrCityCode> <Number>5555555</Number> </TelephoneNumber> </Fax> </Contact> </InvoiceDetailShipping> <Money currency="USD">5.00</Money> </InvoiceDetailLineShipping> <GrossAmount> <Money currency="USD">205.00</Money> </GrossAmount> <NetAmount> <Money currency="USD">205.00</Money> </NetAmount> <Distribution> <Accounting name="Buyer assigned accounting code 1"> <AccountingSegment id="ABC123456789"> <Name xml:lang="en">Purchase</Name> <Description xml:lang="en"> Production Control</Description> </AccountingSegment> </Accounting> <Charge> <Money currency="USD">205.00</Money> </Charge> </Distribution> </InvoiceDetailItem> <InvoiceDetailItem invoiceLineNumber="2" quantity="8"> <UnitOfMeasure>EA</UnitOfMeasure> <UnitPrice> <Money currency="USD">20.00</Money> </UnitPrice> <InvoiceDetailItemReference lineNumber="2"> <ItemID> <SupplierPartID>BTM00108</SupplierPartID> </ItemID> <Description xml:lang="en"> Computer Video Cables</Description> </InvoiceDetailItemReference> <SubtotalAmount> <Money currency="USD">160.00</Money> </SubtotalAmount> <InvoiceDetailLineShipping> <InvoiceDetailShipping> <Contact role="shipFrom" addressID="1000467"> <Name xml:lang="en">Acme </Name> <PostalAddress name="Acme"> <Street>123 Main Street</Street> <City>Anytown</City> <State>PA</State> <PostalCode>99999</PostalCode>

362PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 363: 355a de soluciones cXML - help.sap.com

<Country isoCountryCode="US">United States</Country> </PostalAddress> <Email name="default">[email protected]</Email> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1 </CountryCode> <AreaOrCityCode>800</AreaOrCityCode> <Number>5555555</Number> </TelephoneNumber> </Phone> <Fax name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1 </CountryCode> <AreaOrCityCode></AreaOrCityCode> <Number></Number> </TelephoneNumber> </Fax> </Contact> <Contact role="shipTo" addressID="1000487"> <Name xml:lang="en">Betty Buyer</Name> <PostalAddress name="default"> <DeliverTo>Betty Buyer</DeliverTo> <Street>1314 Chesapeake Terrace</Street> <City>Sunnyvale</City> <State>CA</State> <PostalCode>94089</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> <Email name="default">[email protected] </Email> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1 </CountryCode> <AreaOrCityCode>800</AreaOrCityCode> <Number>66666666</Number> </TelephoneNumber> </Phone> <Fax name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1 </CountryCode> <AreaOrCityCode>215</AreaOrCityCode> <Number>5555555</Number> </TelephoneNumber> </Fax> </Contact> </InvoiceDetailShipping> <Money currency="USD">16.00</Money> </InvoiceDetailLineShipping> <GrossAmount> <Money currency="USD">176.00</Money> </GrossAmount> <NetAmount> <Money currency="USD">176.00</Money> </NetAmount> <Distribution> <Accounting name="Buyer assigned accounting code 1"> <AccountingSegment id="ABC123456789"> <Name xml:lang="en">Purchase</Name> <Description xml:lang="en"> Production Control</Description> </AccountingSegment> </Accounting>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 363

Page 364: 355a de soluciones cXML - help.sap.com

<Charge> <Money currency="USD">176.00</Money> </Charge> </Distribution> </InvoiceDetailItem> </InvoiceDetailOrder> <InvoiceDetailSummary> <SubtotalAmount> <Money currency="USD">360.00</Money> </SubtotalAmount> <Tax> <Money currency="USD">36.00</Money> <Description xml:lang="en">total tax</Description> <TaxDetail purpose="tax" category="State sales tax" percentageRate="10"> <TaxableAmount> <Money currency="USD">360.00</Money> </TaxableAmount> <TaxAmount> <Money currency="USD">36.00</Money> </TaxAmount> <TaxLocation xml:lang="en">PA</TaxLocation> </TaxDetail> </Tax> <ShippingAmount> <Money currency="USD">21.00</Money> </ShippingAmount> <GrossAmount> <Money currency="USD">417.00</Money> </GrossAmount> <NetAmount> <Money currency="USD">417.00</Money> </NetAmount> <DueAmount> <Money currency="USD">417.00</Money> </DueAmount> </InvoiceDetailSummary> </InvoiceDetailRequest> </Request> </cXML>

Abono de ejemplo: Escenario comprador/proveedor complejo

El abono de ejemplo muestra cómo un proveedor aplica un crédito con cargos impositivos.

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cXML.org/schemas/cXML/1.2.014/InvoiceDetail.dtd"><cXML payloadID="CRDO12042-120402" timestamp="2001-12-04T18:00:00-07:00"> <Header> <From> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> </Credential> </From> <To> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> </Credential> </To> <Sender> <Credential domain="AribaNetworkUserId">

364PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 365: 355a de soluciones cXML - help.sap.com

<Identity>[email protected]</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Our Invoicing App 2.0</UserAgent> </Sender> </Header> <Request> <InvoiceDetailRequest> <InvoiceDetailRequestHeader invoiceID="CRDO12042" purpose="creditMemo" operation="new" invoiceDate="2001-12-04T18:00:00-07:00"> <InvoiceDetailHeaderIndicator isHeaderInvoice="yes"/> <InvoiceDetailLineIndicator/> <Comments xml:lang="en-US"> Buyer ordered 5 Computer Video Cables. We invoiced the customer for 8 by mistake. </Comments> </InvoiceDetailRequestHeader> <InvoiceDetailHeaderOrder> <InvoiceDetailOrderInfo> <OrderReference> <DocumentReference payloadID="[email protected]"/> </OrderReference> </InvoiceDetailOrderInfo> <InvoiceDetailOrderSummary invoiceLineNumber="2"> SubtotalAmount> <Money currency="USD">-100.00</Money> </SubtotalAmount> </InvoiceDetailOrderSummary> </InvoiceDetailHeaderOrder> <InvoiceDetailSummary> <SubtotalAmount> <Money currency="USD">-100.00</Money> </SubtotalAmount> <Tax> <Money currency="USD">-10</Money> <Description xml:lang="en">total tax</Description> </Tax> <NetAmount> <Money currency="USD">-110.00</Money> </NetAmount> <DueAmount> <Money currency="USD">-110.00</Money> </DueAmount> </InvoiceDetailSummary> </InvoiceDetailRequest> </Request> </cXML>

Nota de débito de ejemplo: Escenario comprador/proveedor complejoLa nota de débito de ejemplo ilustra cómo un proveedor corrige un error en un abono.

El proveedor se da cuenta de que ha utilizado unos números incorrectos en el abono. Debería haber cobrado a la organización compradora 66€.

La siguiente nota de débito es de 44€ (110€ - 66€).

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cXML.org/schemas/cXML/1.2.014/InvoiceDetail.dtd"><cXML payloadID="DBDO12042-120402" timestamp="2001-12-04T18:50:00-07:00">

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 365

Page 366: 355a de soluciones cXML - help.sap.com

<Header> <From> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> </Credential> </From> <To> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> </Credential> </To> <Sender> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Our Invoicing App 2.0</UserAgent> </Sender> </Header> <Request> <InvoiceDetailRequest> <InvoiceDetailRequestHeader invoiceID="DBDO12042" purpose="debitMemo" operation="new" invoiceDate="2001-12-04T18:50:00-07:00"> <InvoiceDetailHeaderIndicator isHeaderInvoice="yes"/> <InvoiceDetailLineIndicator/> <Comments xml:lang="en-US"> Bigcompany ordered five Computer Video Cables at 20.00 a piece. We invoiced the customer for eight by mistake. We sent out a credit memo for 100.00 instead of 60.00, so now we are issuing this debit memo in the amount of 2 X 20 = 40.00. The customer received all 5 items. Sorry for the confusion. </Comments> </InvoiceDetailRequestHeader> <InvoiceDetailHeaderOrder> <InvoiceDetailOrderInfo> <OrderReference> <DocumentReference payloadID = "[email protected]"/> </OrderReference> </InvoiceDetailOrderInfo> <InvoiceDetailOrderSummary invoiceLineNumber="2"> <SubtotalAmount> <Money currency="USD">40.00</Money> </SubtotalAmount> </InvoiceDetailOrderSummary> </InvoiceDetailHeaderOrder> <InvoiceDetailSummary> <SubtotalAmount> <Money currency="USD">40.00</Money> </SubtotalAmount> <Tax> <Money currency="USD">4.00</Money> <Description xml:lang="en">total tax</Description> </Tax> <NetAmount> <Money currency="USD">44.00</Money> </NetAmount> <DueAmount> <Money currency="USD">44.00</Money> </DueAmount> </InvoiceDetailSummary> </InvoiceDetailRequest> </Request> </cXML>

366PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 367: 355a de soluciones cXML - help.sap.com

Factura de cancelación de ejemplo

El ejemplo ilustra una factura de cancelación. El elemento InvoiceDetailRequestHeader contiene el atributo operation="delete" y el atributo InvoiceID refleja que se trata de una factura de cancelación. También hay un elemento DocumentReference que contiene el payloadID de la factura original, tal y como es necesario por cXML DTD.

Como siempre, este documento tiene un payloadID único.

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cXML.org/schemas/cXML/1.2.014/InvoiceDetail.dtd"> <cXML payloadID="INV123.DELETE" timestamp="2001-12-05T10:22:00-07:00"> <Header> <From> <Credential domain="AribaNetworkUserId"> <Identity>[email protected] </Identity> </Credential> </From> <To> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> </Credential> </To> <Sender> <Credential domain="AribaNetworkUserId"> <Identity>[email protected] </Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Mega Invoicing App 1.0</UserAgent> </Sender> </Header> <Request> <InvoiceDetailRequest> <InvoiceDetailRequestHeader purpose="standard" operation="delete" invoiceID="INV123.DELETE" invoiceDate="2001-12-05T09:30:00-07:00"> <InvoiceDetailHeaderIndicator></InvoiceDetailHeaderIndicator> <InvoiceDetailLineIndicator isTaxInLine="yes" isShippingInLine="yes" isAccountingInLine="yes"> </InvoiceDetailLineIndicator> <InvoicePartner> <Contact role="billTo" addressID="Billing"> <Name xml:lang="en">Test User</Name> <PostalAddress name="billing department"> <DeliverTo>Test User</DeliverTo> <Street>16 Castro Street</Street> <City>Mountain View</City> <State>CA</State> <PostalCode>95035</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> <Email name="default">[email protected]</Email> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode>215</AreaOrCityCode> <Number>9990000</Number> </TelephoneNumber> </Phone> </Contact> <IdReference identifier="11280630" domain="accountReceivableID"> <Creator xml:lang="en">Test Supplier</Creator> </IdReference> </InvoicePartner> <DocumentReference payloadID="INV123">

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 367

Page 368: 355a de soluciones cXML - help.sap.com

</DocumentReference> </InvoiceDetailRequestHeader> <InvoiceDetailOrder> <InvoiceDetailOrderInfo> <OrderReference orderID="PO123"> <DocumentReference payloadID="1002700953000.152865612"> </DocumentReference> </OrderReference> </InvoiceDetailOrderInfo> <InvoiceDetailItem invoiceLineNumber="1" quantity="10"> <UnitOfMeasure>EA</UnitOfMeasure> <UnitPrice> . . .

Pagos programadosLas organizaciones compradoras utilizan los pagos programados (documentos PaymentProposalRequest) para informar a Ariba Network y a sus proveedores sobre pagos planificados. Estos documentos enumeran fechas de pagos programados, importes de descuento e importes netos. Ariba Buyer 8.2 y posterior lo admite.

De forma predeterminada, los pagos programados son meramente informativos. Después de aprobar facturas de proveedores, la aplicación de compras envía pagos programados a Ariba Network. Ariba Network los reenvía a los proveedores mediante correo electrónico o los muestra en sus bandejas de entrada en línea.

Pago EFT [página 368]

Gestión de descuentos [página 369]

Ejemplo de pago programado [página 371]

Pago EFT

Las organizaciones compradoras pueden utilizar pagos programados para el pago automatizado mediante Electronic Funds Transfer (EFT) en Ariba Network.

Después de que la aplicación de compras apruebe las facturas de los proveedores, envía pagos programados a Ariba Network, que los reenvía a los proveedores. En la fecha de pago programado, Ariba Network informa al banco de la organización compradora que pague al banco del proveedor.

Los pagos programados para el pago EFT contienen el atributo isNetworkPayment:

<PaymentProposalRequest paymentDate="2005-01-14T14:34:45-07:00" operation="new" paymentProposalID="PAY123" isNetworkPayment="yes">

368PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 369: 355a de soluciones cXML - help.sap.com

Gestión de descuentos

Se pueden usar pagos programados para descuentos iniciados por el comprador (anteriormente denominado Descuento dinámico), descuentos iniciados por el proveedor y condiciones de pago anticipado regular, que permiten que las organizaciones compradoras y los proveedores negocien una liquidación adelantada para los descuentos.

Después de que una organización compradora apruebe una factura, la aplicación de facturación envía un pago programado a Ariba Network, que lo muestra a los proveedores. Si la organización compradora activa la gestión de descuentos, Ariba Network permite a los proveedores solicitar un pago acelerado, utilizando un porcentaje de descuento configurado por la organización compradora. Si el proveedor activa la gestión de descuentos, Ariba Network permite a la organización compradora revisar y aceptar o rechazar las condiciones de liquidación adelantada. En caso necesario, el proveedor puede revisar la oferta.

Los pagos programados para la gestión de descuentos contienen un elemento especial Extrinsic denominado immediatepay:

<PaymentProposalRequest paymentDate="2021-04-20T23:59:20-07:00" operation="new" paymentProposalID="PAY123"> . . . <Extrinsic name="immediatepay">yes</Extrinsic> </PaymentProposalRequest>

Si un proveedor selecciona un pago programado para la liquidación anticipada, Ariba Network envía un documento CopyRequest que contiene de nuevo el pago programado adjunto para la organización compradora con un importe neto y la fecha de pago actualizados. Este documento PaymentProposalRequest contiene el atributo operation="update".

NotaTras aplicar un descuento a una PaymentProposalRequest, las actualizaciones posteriores de PaymentProposalRequest fallan si los valores GrossAmount o NetAmount no coinciden con los de la PaymentProposalRequest descontada original.

En el ejemplo siguiente se muestra el extrínseco earlyPaymentDiscount. Este importe se utiliza para desplazar el descuento de pago adelantado incluido en la parte del descuento de la propuesta de pago para garantizar que no se produce ninguna medición doble. El valor indica el importe de descuento real.

<PaymentProposalRequest paymentDate="2021-04-20T23:59:20-07:00" operation="new" paymentProposalID="PAY123"> . . . <Extrinsic name="earlyPaymentDiscount"> <Money currency="USD">100</Money> </Extrinsic> </PaymentProposalRequest>

Ajustes fiscales de descuento dinámico

Los compradores pasan bases de descuento en las propuestas de pago de ERP a Ariba Network, cosa que permite que SAP Ariba Discount Management excluya impuestos y otros elementos definidos por ERP del cálculo de descuentos. Ariba Network pasa el importe del descuento, las devoluciones de impuestos y los importes de

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 369

Page 370: 355a de soluciones cXML - help.sap.com

liquidación revisados de vuelta a los ERP del comprador y proveedor cuando un proveedor acepta una oferta de descuento, y visualiza ajustes que resultan en devoluciones de impuestos claramente en el aviso de remesa. Los compradores pueden configurar las combinaciones de categorías de impuestos y el código del lugar de aplicación (que se pueden asignar al país, a la región o la provincia definida para ERP) para los que Ariba Network debería calcular una devolución de impuestos.

La base de descuento tiene que ser igual al importe imponible. No debería excluir otros elementos fiscales de la base de descuento para los países en los que se aplica el ajuste fiscal.

Trabaje con el departamento de TI para configurar su ERP para enviar información de ajustes fiscales acerca de las propuestas de pago.

Para obtener más información sobre la configuración de categorías de impuesto y códigos del lugar de la aplicación, consulte Crear y suprimir reglas de ajustes de impuestos.

Ofertas de condiciones de pago

Las ofertas de condiciones de pago permiten a los compradores y proveedores acordar condiciones de pago diferentes a nivel de factura cuando los requisitos empresariales necesitan mayor flexibilidad en cuanto a las condiciones de pago de la que permiten las condiciones de pago regulares. Ariba Network aplica las condiciones de pago de acuerdo con el atributo paymentTermCode que los compradores incluyen en los documentos de PaymentProposalRequest cXML. Si el atributo paymentTermCode coincide con una Oferta de condición de pago en Ariba Network, SAP Ariba Discount Management aplica dicha condición de pago. Si el atributo paymentTermCode no está presente o no coincide con una Oferta de condición de pago configurada en Ariba Network, SAP Ariba Discount Management utiliza cualquier condición de pago que se habría aplicado en su lugar. PaymentProposalRequest de ejemplo con el atributo paymentTermCode:

<PaymentProposalRequest paymentDate="2021-08-05T11:59:20-07:00" paymentProposalID="5300000322" operation="new"> <PayableInfo> <PayableInvoiceInfo> <InvoiceIDInfo invoiceID="INV322" invoiceDate="2021-07-06"/> </PayableInvoiceInfo> </PayableInfo> <PaymentMethod type="ach"/> <PaymentTerms paymentTermCode="210A"/>

NotaAunque PaymentTerms tiene varios elementos inferiores opcionales, Ariba Network los ignora. Solo se usa su atributo paymentTermCode.

Trabaje con su departamento de TI para pasar el atributo paymentTermCode en documentos cXML de PaymentProposalRequest. Para obtener más información sobre cómo configurar las ofertas de condiciones de pago, consulte Configuración de ofertas de descuento.

370PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 371: 355a de soluciones cXML - help.sap.com

Ejemplo de pago programado

El pago programado de ejemplo muestra un pago ACH. Indica a Ariba Network que presente el pago a los proveedores para la gestión de descuentos.

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cXML.org/schemas/cXML/1.2.014/PaymentRemittance.dtd"><cXML payloadID="[email protected]" timestamp="2005-04-20T23:59:45-07:00"> <Header> <From> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> </Credential> </From> <To> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> </Credential> </To> <Sender> <Credential domain="AribaNetworkUserId"> <Identity>[email protected]</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Super Procurement Application 1.2</UserAgent> </Sender> </Header> <Request> <PaymentProposalRequest paymentProposalID="proposal123" operation="new" paymentDate="2005-05-20T23:59:20-07:00"> <Extrinsic name="immediatepay">yes</Extrinsic> <PayableInfo> <PayableInvoiceInfo> <InvoiceIDInfo invoiceID="ABC" invoiceDate="2005-05-20T22:00:00-07:00"> </InvoiceIDInfo> <PayableOrderInfo> <OrderReference orderID="DEF"> <DocumentReference payloadID="25510.10.81.002"/> </OrderReference> </PayableOrderInfo> </PayableInvoiceInfo> </PayableInfo> <PaymentMethod type="ach"/> <Contact role="remitTo" addressID="Billing"> <Name xml:lang="en">Lisa Dollar</Name> <PostalAddress name="billing department"> <DeliverTo>Lisa Dollar</DeliverTo> <Street>100 Castro Street</Street> <City>Mountain View</City> <State>CA</State> <PostalCode>95035</PostalCode> <Country isoCountryCode="US">United States</Country> </PostalAddress> <Email name="default">[email protected]</Email> <Phone name="work"> <TelephoneNumber> <CountryCode isoCountryCode="US">1</CountryCode> <AreaOrCityCode>650</AreaOrCityCode> <Number>9990000</Number> </TelephoneNumber> </Phone> </Contact> <GrossAmount>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 371

Page 372: 355a de soluciones cXML - help.sap.com

<Money currency="USD">3000.00</Money> </GrossAmount> <DiscountAmount> <Money currency="USD">160.00</Money> </DiscountAmount> <AdjustmentAmount> <Money currency="USD">30.00</Money> </AdjustmentAmount> <NetAmount> <Money currency="USD">2810.00</Money> </NetAmount> </PaymentProposalRequest> </Request> </cXML>

Ejemplo de pago programado con ajustes fiscales

El siguiente es un ejemplo de propuesta de pago actualizada que pasa una base de descuento y un importe del impuesto para el Impuesto sobre bienes y servicios (GST) de la Columbia Británica:

<PaymentProposalRequest paymentProposalID="1100000124" operation="update" paymentDate="2016-04-05T11:59:20-07:00"> <PayableInfo> <PayableInvoiceInfo> <InvoiceIDInfo invoiceID="INV8291087" invoiceDate="2016-04-01T18:31:35+05:30"></InvoiceIDInfo> </PayableInvoiceInfo> </PayableInfo> <PaymentMethod type="ach"></PaymentMethod> <GrossAmount> <Money currency="CAD">13440</Money> </GrossAmount> <DiscountBasis> <Money currency="CAD">12000</Money> </DiscountBasis> <DiscountAmount> <Money currency="CAD">1200</Money> </DiscountAmount> <AdjustmentAmount> <Money currency="CAD">0</Money> </AdjustmentAmount> <Tax> <Money currency="CAD">1440.00</Money> <Description xml:lang="en-US"></Description> <TaxDetail category="gst" percentageRate="5"> <TaxableAmount> <Money currency="CAD">12000.00</Money> </TaxableAmount> <TaxAmount> <Money currency="CAD">600.00</Money> </TaxAmount> <Description xml:lang="en-US"></Description> </TaxDetail> <TaxDetail category="pst" percentageRate="7"> <TaxableAmount> <Money currency="CAD">12000.00</Money> </TaxableAmount> <TaxAmount> <Money currency="CAD">840.00</Money> </TaxAmount> <Description xml:lang="en-US"></Description> </TaxDetail> </Tax>

372PUBLICPÚBLICO

Guía de soluciones cXMLFacturas y pagos programados

Page 373: 355a de soluciones cXML - help.sap.com

<TaxAdjustment> <Money currency=“CAD”>60</Money> <TaxAdjustmentDetail category=“gst” location=“BC"> <Money currency="CAD">60</Money> </TaxAdjustmentDetail> </TaxAdjustment> <NetAmount> <Money currency="CAD">12180</Money> </NetAmount> <Extrinsic name="Scheduling"></Extrinsic> <Extrinsic name="Scheduled">yes</Extrinsic> <Extrinsic name="immediatepay">yes</Extrinsic> </PaymentProposalRequest>

Guía de soluciones cXMLFacturas y pagos programados

PUBLICPÚBLICO 373

Page 374: 355a de soluciones cXML - help.sap.com

Recibos

Los recibos indican que su organización ha recibido productos o servicios pedidos. Sus encargados de expedición o solicitantes los crean y los envían a SAP Ariba Invoice Management mediante Ariba Network. El personal encargado de las cuentas por pagar los utiliza (además de los pedidos de compra y facturas) para determinar cuándo y cuánto han de pagar a los proveedores.

Enrutamiento ReceiptRequest [página 374]

Documento ReceiptRequest [página 374]

Documento de recibo de ejemplo [página 380]

Enrutamiento ReceiptRequestSu organización genera recibos y los envía a los proveedores. Ariba Network los enruta a SAP Ariba Invoice Management. La credencial To en la cabecera de documento especifica el proveedor.

Ariba Network enruta los recibos inmediatamente a SAP Ariba Invoice Management y envía copias a la página Recibos de su pestaña Bandeja de salida en línea. No empareja recibos con sus correspondientes documentos. Esto le permite enviar recibos para pedidos de compra o acuerdos maestros vencidos o para pedidos de compra que no se han enrutado a través de Ariba Network.

En SAP Ariba Invoice Management, los usuarios utilizan los recibos (si son precisos) y los pedidos de compra para asegurarse de que las facturas que reciben de los proveedores son correctas. Consulte Tipos de recepción en SAP Ariba Invoice Management [página 165] para obtener información acerca de la configuración de requisitos de recibo para artículos de pedido

Documento ReceiptRequestEl documento cXML ReceiptRequest representa recibos. Define la información de recibo de un pedido de compra o acuerdo maestro con detalles de artículos. Una línea de recibo es un elemento ReceiptItem con un número de línea de recibo.

Cada documento ReceiptRequest representa detalles sobre un recibo contra un pedido de compra o un acuerdo maestro enviado desde una organización compradora a un proveedor. Puede utilizarlo para cualquier parte de todos o algunos artículos en línea de pedidos de compra individuales o múltiples.

NotaEl documento ReceiptRequest se define en Fulfill.dtd en lugar de en cXML.dtd.

ReceiptRequestHeader [página 375]

374PUBLICPÚBLICO

Guía de soluciones cXMLRecibos

Page 375: 355a de soluciones cXML - help.sap.com

ReceiptOrder [página 376]

ReceiptRequestHeader

El elemento ReceiptRequestHeader contiene información de cabecera para este recibo.

ReceiptRequestHeader adopta los siguientes atributos:

Atributo Descripción

receiptID (obligatorio) Un identificador único generado por el comprador para este recibo.

receiptDate (obligatorio) La fecha y la hora en la que la organización compradora recibió los artículos o servicios. Esta fecha y hora debería ser anterior a la marca de tiempo del documento.

operation La operación descrita por este documento de recibo. Debe ser "new".

Comments

El atributo opcional Comments le permite efectuar comentarios con el recibo.

Extrínseco

El elemento opcional Extrinsic le permite proporcionar información adicional relativa a un recibo. La información en un elemento extrínseco no debería duplicar información contenida en cualquier otro lugar del documento ReceiptRequest.

Extrínsecos para las referencias de recibo en los recibos de devolución

Para la verificación de facturas basada en el recibo de bienes, el cXML para los recibos de devolución debe incluir una referencia al recibo original para especificar para que recibo de bienes es la devolución. Los extrínsecos ReceiptReference y ReceiptReferenceDate llevan esta información en la sección ReceiptRequestHeader de CopyReceipt.

<ReceiptRequestHeader receiptID=”ReversalOfGR1" receiptDate="2017-08-15T15:42:11-07:00" operation="new"> <Extrinsic name="ReceiptReference">GR1</Extrinsic> <Extrinsic name="ReceiptReferenceDate">2017-08-15T15:42:11-07:00</Extrinsic> </ReceiptRequestHeader>

Guía de soluciones cXMLRecibos

PUBLICPÚBLICO 375

Page 376: 355a de soluciones cXML - help.sap.com

ReceiptOrder

El elemento ReceiptOrder define información relacionada con un pedido de compra o un acuerdo maestro. Un documento ReceiptRequest puede contener múltiples elementos ReceiptOrder.

El elemento ReceiptOrder tiene el atributo siguiente:

Atributo Descripción

closeForReceiving Marca que indica que el pedido base o el acuerdo maestro tiene que cerrarse para la posterior recepción en la aprobación de este recibo. El valor predeterminado es "falso" (no).

Si este recibo se ha emitido contra un pedido de compra o un pedido preferente, esta marca indica que el correspondiente pedido debería cerrarse para la recepción. Si este recibo se ha emitido contra un acuerdo marco no preferente, esta marca indica que el pedido marco debería cerrarse para la recepción.

ReceiptOrderInfo [página 376]

ReceiptItem [página 377]

Total [página 379]

ReceiptOrderInfo

El elemento ReceiptOrderInfo contiene la información de referencia del pedido de compra o el acuerdo maestro. Las distintas opciones de contenido son, por orden de preferencia, las siguientes: OrderReference, MasterAgreementReference, MasterAgreementIDInfo o OrderIDInfo.

OrderReference

Una referencia al pedido de compra que contiene los artículos o servicios que se han recibido.

MasterAgreementReference

Una referencia al acuerdo marco que contiene los artículos o servicios que se reciben.

OrderIDInfo

El ID de comprador del correspondiente pedido de compra.

376PUBLICPÚBLICO

Guía de soluciones cXMLRecibos

Page 377: 355a de soluciones cXML - help.sap.com

MasterAgreementIDInfo

El ID de comprador del correspondiente acuerdo marco.

ReceiptItem

El elemento ReceiptItem define un artículo en línea de recibo mediante información procedente del pedido de compra o el acuerdo maestro.

Si este recibo se emite contra un pedido preferente, especifique tanto el pedido preferente como el acuerdo maestro.

Si el recibo se emite contra un acuerdo maestro no preferente, especifique únicamente el acuerdo maestro.

Si el recibo se emite contra un pedido de compra, especifique el pedido de compra.

Este elemento tiene los atributos siguientes:

Atributo Descripción

receiptLineNumber(obligatorio)

Un ID definido por el comprador para el artículo en línea actual. Debe ser unívoco en todos los artículos en línea de recibo del mismo documento ReceiptRequest.

quantity(obligatorio)

La cantidad recibida para la línea de recibo actual.

Los valores negativos en el atributo quantity indican una acción correctiva contra un pedido que se ha recibido o devuelto con errores. Por ejemplo hay un pedido que tiene un artículo en línea con 20 como cantidad y originalmente se especificó 20 como cantidad recibida; sin em­bargo, si después se detectó que la cantidad recibida era sólo 15 y no 20, puede efectuar una recepción negativa para corregir este error.

<ReceiptItem receiptLineNumber="1" quantity="-5" type="received">

type Para indicar si el comprador ha recibido o devuelto los artículos del proveedor. Este atributo puede adoptar los valores siguientes:

● received: Indica las mercancías recibidas por el comprador.Por ejemplo:

<ReceiptItem receiptLineNumber="1" quantity="20" type="received">● returned: Indica las mercancías devueltas por el comprador.

Por ejemplo:

<ReceiptItem receiptLineNumber="1" quantity="10" type="returned">

Guía de soluciones cXMLRecibos

PUBLICPÚBLICO 377

Page 378: 355a de soluciones cXML - help.sap.com

ReceiptItemReference

La referencia ReceiptItem indica el número de línea de un artículo en línea referenciado.

ReceiptItemReference tiene el siguiente atributo:

Atributo Descripción

lineNumber(obligatorio)

Número de línea del artículo en línea, copiado de OrderRequest

ItemID

El número de pieza del proveedor del artículo en línea actual, copiado de la OrderRequest.

Descripción

La descripción del artículo en línea copiada de OrderRequest.

ManufacturerPartID

El número de pieza del fabricante.

ManufacturerName

El nombre del fabricante.

ShipNoticeReference

Referencia al documento ShipNoticeRequest del proveedor.

ShipNoticeIDInfo

ID de la ShipNoticeRequest. Este ID se utiliza cuando se omite el elemento ShipNoticeReference.

378PUBLICPÚBLICO

Guía de soluciones cXMLRecibos

Page 379: 355a de soluciones cXML - help.sap.com

UnitRate

El importe a pagar por unidad de medida especificada.

ReceivedAmount

Importe en dinero de bienes o servicios recibidos para el artículo en línea de recibo. El importe total recibido debe ser igual a quantity x UnitRate.

AssetInfo

El elemento AssetInfo contiene datos de activos opcionales para cada cantidad de cada artículo en línea de recibo.

Este elemento tiene los atributos siguientes:

Atributo Descripción

tagNumber Número de etiqueta interno para este activo

serialNumber Número en serie de fabricación para este activo

location Ubicación de este activo

Comments

El elemento Comments le permite agregar comentarios para este artículo en línea

Total

El elemento Total proporciona un resumen del importe total de todos los importes de artículos en línea con recibo.

Dinero

El atributo Money especifica el tipo de divisa del importe total en dinero representado por el recibo.

Guía de soluciones cXMLRecibos

PUBLICPÚBLICO 379

Page 380: 355a de soluciones cXML - help.sap.com

Documento de recibo de ejemploEl documento de recibo de ejemplo es para dos monitores de ordenador. Cierra el correspondiente pedido de compra para su posterior recepción.

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://svcdev.ariba.com/schemas/cXML/1.2.015/Private.dtd"><cXML xml:lang="en-US" payloadID="[email protected]" timestamp="2005-11-13T23:00:00-08:00"> <Header> <From> <Credential domain="NetworkID"> <Identity>AN13000001260</Identity> </Credential> </From> <To> <Credential domain="NetworkID"> <Identity>AN12000002259</Identity> </Credential> </To> <Sender> <Credential domain="NetworkID"> <Identity>AN13000001260</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Our Receiving Application, V1.2</UserAgent> </Sender> </Header> <Request> <ReceiptRequest> <ReceiptRequestHeader receiptID="RC1234" receiptDate="2005-11-13T22:00:00-08:00" operation="new"/> <ReceiptOrder closeForReceiving="yes"> <ReceiptOrderInfo> <OrderReference orderID="DO19"> <DocumentReference payloadID="112.334.44.=90"/> </OrderReference> </ReceiptOrderInfo> <ReceiptItem receiptLineNumber="1" quantity="2" type="received"> <ReceiptItemReference lineNumber="1"> <ItemID> <SupplierPartID>RCA15</SupplierPartID> </ItemID> <Description xml:lang="en">Computer Monitor</Description> <ManufacturerPartID>718177215</ManufacturerPartID> <ManufacturerName>RCA</ManufacturerName> </ReceiptItemReference> <UnitRate> <Money currency="USD">150.50</Money> <UnitOfMeasure>EA</UnitOfMeasure> </UnitRate> <ReceivedAmount> <Money currency="USD">301.00</Money> </ReceivedAmount> <AssetInfo serialNumber="SER20201" tagNumber="tag000005" location="Sunnyvale"/> <AssetInfo serialNumber="SER20202" tagNumber="tag000006" location="Sunnyvale"/> </ReceiptItem> </ReceiptOrder> <Total> <Money currency="USD">301.00</Money> </Total> </ReceiptRequest> </Request>

380PUBLICPÚBLICO

Guía de soluciones cXMLRecibos

Page 381: 355a de soluciones cXML - help.sap.com

</cXML>

Guía de soluciones cXMLRecibos

PUBLICPÚBLICO 381

Page 382: 355a de soluciones cXML - help.sap.com

Transacción de carga de catálogo

La transacción Carga de catálogo cXML permite a los proveedores cargar y publicar catálogos en Ariba Network de forma programada. La transacción proporciona una alternativa para iniciar sesión en Ariba Network para cargar y publicar catálogos de forma interactiva. Utilícela para distribuir de forma automática catálogos actualizados siempre que modifique los precios o la disponibilidad de los productos o servicios.

Ariba Network admite cualquier catálogo en formato CIF, cXML o BMEcat. Un catálogo CIF puede ser un archivo de texto guardado con una extensión .cif o un archivo de Excel guardado con una extensión .xls. Si utiliza la transacción Carga de catálogo, el catálogo no puede superar los 10 MB.

Ariba Network sólo permite que los proveedores, no organizaciones compradoras, carguen catálogos.

Antes de cargar un archivo de Excel como catálogo, asegúrese de que éste no exceda 1 MB. Comprima todos los archivos de Excel que superen este límite antes de intentar cargarlos.

La transacción le proporciona una alternativa para iniciar sesión en Ariba Network para cargar y publicar catálogos de forma interactiva. Puede utilizarla para distribuir automáticamente catálogos actualizados siempre que modifique los precios o la disponibilidad de sus productos o servicios.

Resumen de la transacción de carga de catálogo [página 382]

Requisitos previos de CatalogUpoadRequest [página 383]

Documento CatalogUploadRequest [página 384]

Cómo adjuntar un catálogo [página 387]

Ejemplo de cómo enviar un documento CatalogUploadRequest [página 388]

Recepción de la respuesta [página 389]

Recepción del estado de catálogo posterior [página 390]

Resumen de la transacción de carga de catálogoLa transacción Carga de catálogo consta de dos documentos cXML,CatalogUploadRequest y Response.

El objetivo de estos documentos es el siguiente:

Documento cXML Objetivo

CatalogUploadRequest Enviado por proveedores para cargar un catálogo. Contiene el catálogo como un adjunto y es­pecifica si el catálogo es nuevo o una actualización, y si publicarlo automáticamente después de la carga.

Response Enviado por Ariba Network para confirmar la recepción de una CatalogUploadRequest.

Estos documentos utilizan el mecanismo de transporte cXML estándar para viajar entre su aplicación de gestión de catálogos habilitada para cXML y Ariba Network:

1. Su aplicación de gestión de catálogos abre una conexión HTTPS a Ariba Network y lleva a cabo un POST para enviar el documento CatalogUploadRequest.

382PUBLICPÚBLICO

Guía de soluciones cXMLTransacción de carga de catálogo

Page 383: 355a de soluciones cXML - help.sap.com

2. Ariba Network recibe el documento, lo valida y lo analiza.3. Después de verificar la credencial, Ariba envía un documento Response a través de la misma conexión HTTPS.4. Su aplicación recibe el documento Response y cierra la conexión HTTPS.

Puede recibir un estado adicional en cuanto al catálogo a través del correo electrónico o cXML.

Requisitos previos de CatalogUpoadRequest

La transacción CatalogUploadRequest tiene requisitos para su cuenta de Ariba Network, aplicaciones habilitadas para cXML y autentificación de documentos cXML. También requiere catálogos válidos.

Cuenta de Ariba Network

Puede tener una cuenta de proveedor estándar o empresarial en Ariba Network para cargar la transacción CatalogUploadRequest. Sin embargo, si tiene una cuenta de proveedor estándar, debe tener una relación de comprador activa.

Aplicación habilitada para cXML

Debe tener una aplicación habilitada para cXML que pueda iniciar operaciones HTTPS POST.

Las aplicaciones habilitadas para cXML deben admitir el envío y la recepción de la transacción ProfileRequest. Esta transacción es importante para la transacción Carga de catálogo porque:

● La utilizará para buscar la URL a la que publicar el documento CatalogUploadRequest.● Ariba Network la utilizará para buscar la URL a la que publicar documentos StatusUpdateRequest para la

posterior notificación de estado del catálogo.

Autentificación de documentos cXML

Debe haber configurado su cuenta Ariba Network y su aplicación habilitada para cXML para autentificar documentos cXML recibidos [página 38].

Debe ser administrador de la cuenta para cambiar la configuración de la cuenta, como el método de autentificación cXML.

Guía de soluciones cXMLTransacción de carga de catálogo

PUBLICPÚBLICO 383

Page 384: 355a de soluciones cXML - help.sap.com

Catálogos válidos

Debe tener catálogos válidos. Los catálogos pueden tener los formatos siguientes: CIF 2.1, CIF 3.0, cXML, BMEcat o Excel.

Para depurar sus catálogos a medida que los va desarrollando, utilice su cuenta de Ariba Network para cargarlos. Ariba Network los valida automáticamente y marca cualquier error sintáctico. Sus catálogos se validarán cuando utilice la transacción CatalogUploadRequest, pero la resolución de problemas del catálogo [página 389] es mucho más sencilla en las sesiones interactivas. Las sesiones interactivas también le permiten utilizar el responsable de pruebas del pedido para ejercitar los catálogos y generar pedidos de compra de prueba. Comprima los catálogos grandes antes de cargarlos.

NotaNo puede utilizar la transacción CatalogUploadRequest para publicar catálogos nuevos para los compradores. Puede publicar un catálogo con la transacción CatalogUploadRequest solo si ya existe una versión anterior del catálogo en Ariba Network.

Sin embargo, en el caso de catálogos BMEcat, puede utilizar la transacción CatalogUploadRequest para publicar los catálogos nuevos admás de las actualizaciones en los catálogos existentes para los compradores con CMS. Estos catálogos no se validan con Ariba Network y se publican automáticamente en CMS en la solución de SAP Ariba de comprador. No tiene que iniciar sesión en su cuenta y publicar estos catálogos manualmente.

Para obtener más información sobre… Consulte…

Crear catálogos CIF o cXML Referencia sobre formato de catálogo

Crear catálogos en formato Excel Creación y gestión de catálogos

Cargar, validar y evaluar catálogos Creación y gestión de catálogos

Documento CatalogUploadRequest

Un documento CatalogUploadRequest contiene To y CatalogUploadRequest, y requiere que adjunte su catálogo válido.

Elemento To

El elemento To puede especificar Ariba Network o la organización compradora.

Si dirige el documento a Ariba Network, Ariba Network lleva a cabo una validación genérica de catálogos, no una validación de catálogos específica de comprador. Si dirige el documento a una organización compradora, Ariba Network lleva a cabo una validación contra las reglas de catálogo del cliente.

384PUBLICPÚBLICO

Guía de soluciones cXMLTransacción de carga de catálogo

Page 385: 355a de soluciones cXML - help.sap.com

Elemento CatalogUploadRequest

CatalogUploadRequest tiene un atributo Operation que especifica el tipo de carga a llevar a cabo. También contiene varios elementos que detallan aspectos de la solicitud.

El atributo Operation es uno de:

● new: Carga un catálogo nuevo. No debe existir ningún catálogo con el mismo nombre.● update: Sobrescribe un catálogo existente. Debe existir ningún catálogo con el mismo nombre.

Elemento CatalogName

CatalogName especifica el nombre del catálogo cargado. Este valor es el nombre visible del usuario, no el nombre de archivo del catálogo.

CatalogName tiene un atributo xml:lang que especifica el idioma utilizado para el nombre del catálogo. Los códigos de idioma se definen en Especificación XML 1.0 (en http://www.w3.org/TR/1998/REC-xml-19980210.html

). En el caso más común, esto incluye un código de idioma ISO 639 y, opcionalmente, un código de idioma ISO 3166 separado por un guion. El formato del código de idioma cXML recomendado es xx[-YY[-zzz]*], dónde xx es un código de idioma ISO 639, YY es un código de país ISO 3166 y zzz es un IANA o subcódigo privado para el idioma en cuestión. De nuevo, se recomienda utilizar siempre el código de país. Convencionalmente, el código de idioma se escribe en minúsculas y el código de país, en mayúsculas. Esto no es necesario para la coincidencia correcta de los códigos.

Descripción

Description describe brevemente los contenidos del catálogo. Las organizaciones compradoras pueden buscar y ver esta información.

Description tiene un atributo xml:lang que especifica el idioma del texto de descripción.

Elemento Attachment

Attachment especifica la URL del catálogo adjunto. Contiene un elemento URL con el esquema "cid:".

Información relacionada

Recepción de la respuesta [página 389]

Guía de soluciones cXMLTransacción de carga de catálogo

PUBLICPÚBLICO 385

Page 386: 355a de soluciones cXML - help.sap.com

Elemento de mercancías

Commodities especifica los códigos de mercancías de nivel superior para los artículos de su catálogo. Las organizaciones compradoras utilizan estos códigos para buscar catálogos nuevos. Contiene uno o varios elementos CommodityCode.

Utiliza códigos de segmento UNSPSC (United Nations Standard Products and Services Code) de dos dígitos.

Información relacionada

Sistemas de codificación recomendados [página 422]

Elemento AutoPublish

AutoPublish publica automáticamente el catálogo para las organizaciones compradoras tras la carga.

Puede publicar automáticamente sólo si se cumplen los siguientes requisitos:

● Existe una versión anterior del catálogo en su cuenta y está llevando a cabo una operación update.● La versión anterior está en estado "publicada". Debe haberse publicado de manera privada (con una lista de

organizaciones compradoras) o pública.● CatalogUploadRequest (el elemento To) se dirige a uno de sus clientes, no Ariba Network.

AutoPublish tiene un atributo habilitado que especifica si publicar el catálogo automáticamente o no:

● true: Publica el catálogo. Debe ser una actualización del catálogo publicado anteriormente.● false: No publica el catálogo. Puede iniciar sesión en su cuenta y publicar el catálogo manualmente.

NotaLos catálogos BMEcat se publican automáticamente después de la carga independientemente de si el elemento AutoPublish en el documento cXML CatalogUploadRequest está fijado en true o false.

Elemento Notification

Notification envía notificaciones de estado del catálogo por correo electrónico o cXML POST.

Para ver ejemplos de estos mensajes, consulte Recepción del estado de catálogo posterior [página 390].

Notification contiene uno o ambos elementos Email y elementos URLPost.

386PUBLICPÚBLICO

Guía de soluciones cXMLTransacción de carga de catálogo

Page 387: 355a de soluciones cXML - help.sap.com

Elemento Email

Email especifica el buzón de correo para los mensajes de estado por correo electrónico Ariba Network. Sólo puede utilizar un elemento Email, y sólo puede contener una dirección de correo electrónico.

Elemento URLPost

URLPost especifica si Ariba Network envía mensajes de estado de catálogo como documentos StatusUpdateRequest cXML.

El destino URL de la StatusUpdateRequest viene determinado por la respuesta de su sitio web a la transacción de Ariba Network ProfileRequest.

URLPost tiene un atributo habilitado que especifica si Ariba Network envía notificaciones de estado de catálogo mediante StatusUpdateRequest:

● true: Activa esta función.● false: Desactiva esta función.

Información relacionada

Transacción Perfil [página 73]

Cómo adjuntar un catálogoEnvíe su catálogo adjuntado al documento CatalogUploadRequest como un adjunto MIME. Es necesario comprimir los catálogos grandes antes de cargarlos.

Utilización de un sobre MIME

Incluya el archivo del catálogo en la CatalogUpdateRequest como un adjunto Multipurpose Internet Mail Extensions (MIME). cXML sólo contiene referencias a partes MIME externas enviadas en un sobre MIME de varias partes.

El archivo del catálogo referenciado debe estar en un sobre MIME de varias partes con el documento cXML. Un requisito cXML para este sobre (sobre los aspectos básicos descritos en RFC 2046 "Multipurpose Internet Mail Extensions, parte dos: Tipos de medios") es la inclusión de cabeceras de ID de contenido con el archivo adjunto.

Guía de soluciones cXMLTransacción de carga de catálogo

PUBLICPÚBLICO 387

Page 388: 355a de soluciones cXML - help.sap.com

NotaLa especificación cXML permite que los adjuntos residan fuera del sobre MIME, pero la transacción Carga de catálogo no admite este método para adjuntar archivos.

El elemento Attachment sólo contiene una referencia a la parte MIME externa del adjunto. Attachment contiene una URL simple con el esquema "cid:". No utilice ningún tipo de codificación para el catálogo, excepto el conjunto de caracteres adecuado para la codificación (por ejemplo, UTF-8). No codifique el catálogo en base64.

Para obtener más información sobre los adjuntos en cXML, consulte el debate del elemento Attachment en la Guía de referencia de cXML en http://www.cxml.org .

Compresión de catálogos

Antes de adjuntar catálogos más grandes de 3 MB, comprímalos con una herramienta ZIP, como por ejemplo WinZip.

Los archivos de catálogo deben tener una extensión .xml, .cif, .xls o .zip.

Ejemplo de cómo enviar un documento CatalogUploadRequestEl ejemplo de cómo enviar un documento CatalogUploadRequest contiene dos documentos en un sobre MIME: Un documento CatalogUploadRequest y un catálogo CIF 3.0.

--kdflkajfdksadjfklasdjfkljdfdsfdkf Content-type: text/xml; charset=UTF-8Content-ID: <[email protected]><?xml version="1.0" encoding="UTF-8"?><!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.023/cXML.dtd"><cXML timestamp="2011-12-28T16:56:03-08:00" payloadID="[email protected]"> <Header> <From> <Credential domain="DUNS"> <Identity>123456789</Identity> </Credential> </From> <To> <Credential domain="NetworkID"> <Identity>AN01000000001</Identity> </Credential> </To> <Sender> <Credential domain="DUNS"> <Identity>123456789</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>MyHomemadeCatalogManager</UserAgent> </Sender> </Header> <Request>

388PUBLICPÚBLICO

Guía de soluciones cXMLTransacción de carga de catálogo

Page 389: 355a de soluciones cXML - help.sap.com

<CatalogUploadRequest operation="update"> <CatalogName xml:lang="en">Winter Prices</CatalogName> <Description xml:lang="en">This catalog contains our premiere-level prices for office chairs and other durable furniture.</Description> <Attachment> <URL>cid: [email protected]</URL> </Attachment> <Commodities> CommodityCode>52</CommodityCode> </Commodities> <AutoPublish enabled="true"/> <Notification> <Email>[email protected]</Email> <URLPost enabled="true"/> </Notification> </CatalogUploadRequest> </Request></cXML>--kdflkajfdksadjfklasdjfkljdfdsfdkfContent-type: text/plain; charset=US-ASCIIContent-Disposition: attachment; filename=PremiereCatalog.cifContent-ID: <[email protected]>Content-length: 364CIF_I_V3.0LOADMODE: FCODEFORMAT: UNSPSCCURRENCY: USDSUPPLIERID_DOMAIN: DUNSITEMCOUNT: 3TIMESTAMP: 2006-01-15 15:25:04DATA942888710,34A11,C11,"Eames Chair",11116767,400.00,EA,3,"Fast MFG",,,400.00942888710,56A12,C12,"Eames Ottoman",11116767,100.00,EA,3,"Fast MFG",,,100.00942888710,78A13,C13,"Folding Chair",11116767,25.95,EA,3,"Fast MFG",,,25.95ENDOFDATA --kdflkajfdksadjfklasdjfkljdfdsfdkf--

Recepción de la respuestaDespués de enviar una CatalogUploadRequest, Ariba Network responde con un documento Response cXML predeterminado.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.024/cXML.dtd"><cXML payloadID="[email protected]" timestamp="2011-01-23T19:21:47-08:00"> <Response> <Status code="201" text="Accepted">The catalog upload request is processing</Status> </Response> </cXML>

Guía de soluciones cXMLTransacción de carga de catálogo

PUBLICPÚBLICO 389

Page 390: 355a de soluciones cXML - help.sap.com

En la tabla siguiente se enumeran los posibles códigos de estado:

Código de estado Significado

200 Correcto La solicitud de carga de catálogo es correcta.

201 Aceptado La solicitud de carga de catálogo está en curso.

461 Código de mercancía erróneo

El código de mercancía que ha asignado al catálogo no es válido.

462 Error de notificación Ningún método de notificación (correo electrónico o URL) proporcionado.

463 Formato de catálogo inco­rrecto

El archivo ZIP no es válido.

464 Catálogo erróneo Ningún catálogo adjuntado, o se ha adjuntado más de un catálogo.

465 Nombre de catálogo du­plicado

El nombre del catálogo ya existe.

466 Ningún catálogo para ac­tualizar

El catálogo que se debe actualizar no existe.

467 Publicación no permitida Intentó publicar un catálogo que no se había publicado anteriormente.

468 Catálogo demasiado grande

El tamaño del catálogo supera el límite de 10 MB.

469 Extensión de catálogo errónea

El nombre del archivo del catálogo debe tener una de las extensiones siguientes: .cif, .xml o .zip.

470 Catálogo con errores El mensaje es el estado del catálogo. (Con errores)

499 Error de tamaño de docu­mento

El documento cXML es demasiado grande.

561 Demasiados catálogos No puede cargar más de un número específico de catálogos por hora.

562 Publicación desactivada La publicación de catálogos no está disponible actualmente debido a un mantenimiento pro­gramado. Volverá a estar en línea en la fecha y hora indicadas.

563 Catálogo en proceso de validación

Intentó actualizar un catálogo antes de que terminara la validación de una versión anterior del catálogo.

564 Carga desactivada La carga de catálogos no está disponible actualmente debido a un mantenimiento programado. Vuelva a intentarlo más tarde.

Para ver otros códigos de estado, consulte la Guía del referencia de cXML en http://www.cxml.org .

Recepción del estado de catálogo posteriorSi incluye el elemento Notification para solicitar una notificación de estado de catálogo posterior, Ariba Network envía un mensaje cuando el catálogo alcanza su estado final.

390PUBLICPÚBLICO

Guía de soluciones cXMLTransacción de carga de catálogo

Page 391: 355a de soluciones cXML - help.sap.com

Los posibles estados finales del catálogo son:

Estado Significado

Validated El catálogo no contiene ningún error de sintaxis.

BadZipFormat El formato ZIP no es correcto.

HasErrors El catálogo contiene errores de sintaxis y no se puede publicar.

Published El catálogo se ha publicado (privado o público).

Esta notificación no aparece en su bandeja de entrada de Ariba Network. Sólo lo recibe mediante correo electrónico o URLPost.

Notificación por correo electrónico de estado del catálogo

Si especifica un buzón de correo electrónico para recibir actualizaciones de estado de catálogo en CatalogUpdateRequest, a continuación, Ariba Network enviará las notificaciones de estado allí.

El ejemplo siguiente muestra una notificación de estado por correo electrónico:

From: [email protected] To: [email protected] Subject: Status of CatalogUploadRequest for Winter Prices from the Ariba Network Catalog Name: Winter PricesStatus: PublishedPayload ID: [email protected] Please log in to your Ariba Network account to view or edit the catalog file. Thank you, Ariba Network Customer Service

Notificación URLPost de estado del catálogo

Si especifica URLPost para recibir actualizaciones de estado de catálogo en CatalogUpdateRequest, Ariba Network envía un mensaje cXML a la URL especificada.

En el ejemplo siguiente se muestra una notificación StatusUpdateRequest enviada por Ariba Network:

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd"><cXML timestamp="2001-01-23T18:39:44-08:00" payloadID="[email protected]"> <Header> <From> <Credential domain="NetworkID"> <Identity>AN01000000001</Identity> </Credential> </From> <To> <Credential domain="DUNS"> <Identity>123456789</Identity> </Credential> </To> <Sender>

Guía de soluciones cXMLTransacción de carga de catálogo

PUBLICPÚBLICO 391

Page 392: 355a de soluciones cXML - help.sap.com

<Credential domain="NetworkID"> <Identity>AN01000000001</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>ANValidator</UserAgent> </Sender> </Header> <Request> <StatusUpdateRequest> <DocumentReference payloadID="[email protected]"> </DocumentReference> <Status text="Success" code="200"> Validated </Status> </StatusUpdateRequest> </Request> </cXML>

Los posibles códigos de estado son:

Código de estado Significado

200 Correcto La solicitud de carga de catálogo es correcta.

463 Formato de catálogo incorrecto El archivo ZIP no es válido.

470 Catálogo con errores El mensaje es el estado del catálogo. (Con errores)

392PUBLICPÚBLICO

Guía de soluciones cXMLTransacción de carga de catálogo

Page 393: 355a de soluciones cXML - help.sap.com

Negociaciones de financiación de la cadena de suministro

Los documentos cXML TradeRequest se utilizan para el método de descuentos de financiación de la cadena de suministro. Cada cXML TradeRequest corresponde a un documento de negociación en Ariba Network.

Los documentos de negociación se asocian a documentos PaymentProposalRequest negociados en la plataforma comercial PrimeRevenue. Las propuestas de pago puede negociarse de forma manual o automática tal y como indica el atributo autoTrade de TradeRequestHeader.

Los documentos TradeRequest se transfieren del proveedor de financiación de la cadena de suministro a Ariba Network. Ariba Network genera las PaymentProposalRequests actualizadas y se envían al comprador o proveedor según sea necesario.

TradeRequest tiene la siguiente estructura básica:

● TradeRequestHeader: indica el comprador, proveedor y financiador de terceros● TradeRequestSummary: indica el valor original del pago programado, créditos y tarifas y el importe

negociado.● TradeItems que indican los pagos específicos que se han negociado con financiadores de terceros.

Este es un ejemplo de un documento TradeRequest:

<TradeRequest> <TradeRequestHeader operation="new" status="accepted" tradeID="trade200922" tradeDate="2015-09-30T10:43:36-07:00" tradeApprovedDate="2015-09-30T12:43:36-07:00" settlementDate="2015-10-02T10:43:36-07:00" autoTrade="no"> <PaymentPartner> <!—Funder information--> <Contact role="payer"> <Name xml:lang="en">Bank Of America</Name> <IdReference domain="financialInstitutionID" identifier="987654321"> </IdReference> </Contact> </PaymentPartner> <PaymentPartner> <!-- supplier information --> <Contact role="payee"> <Name xml:lang="en">Supplier Name</Name> </Contact> </PaymentPartner> <Contact> <Name xml:lang = "en">John Smith</Name> <Phone> <!—optional --> <TelephoneNumber> <CountryCode isoCountryCode = "BE">32</CountryCode> <AreaOrCityCode/> <Number>0477 07 26 41</Number> </TelephoneNumber> </Phone> </Contact> <Comments>Optional comments</Commets> </TradeRequestHeader> <TradeRequestSummary> <!— trade level totals --> <OriginalAmount> <!— sum of all OriginalAmount of all TradeItems -->

Guía de soluciones cXMLNegociaciones de financiación de la cadena de suministro

PUBLICPÚBLICO 393

Page 394: 355a de soluciones cXML - help.sap.com

<Money currency="USD">1000</Money> </OriginalAmount> <CreditApplied> <!— sum of all credit applied of all TradeItems --> <Money currency="USD">100</Money> </CreditApplied > <FeeAmount> <!-- total fee --> <Money currency="USD">20</Money> </Feemount > <Amount > <!-- total projected amount to be paid to supplier --> <Money currency="USD">880</Money> </Amount > </TradeRequestSummary> <TradeItem lineNumber=”1” paymentProposalID="PPR910" maturityDate="2015-04-30T10:43:36-07:00"> <PayableInfo> <PayableInvoiceInfo> <InvoiceIDInfo invoiceDate="2015-03-30T10:43:36-07:00" invoiceID="330inv1"></InvoiceIDInfo> </PayableInvoiceInfo> </PayableInfo> <OriginalAmount > <!-- payment amount of the original PPR --> <Money currency="USD">1000</Money> </OriginalAmount > <AdjustmentAmount> <Money currency="USD”>100.00</Money> <Modifications> <Modification> <AdditionalDeduction type="creditApplied"> <DeductionAmount> <Money currency="USD">100.00</Money> </DeductionAmount> </AdditionalDeduction> </Modification> </Modifications> </AdjustmentAmount> <DaysPaidEarly>10</DaysPaidEarly> <Amount> <!-- trade amount: GrossAmount - AdjustmentAmount - FeeAmount--> <Money currency="USD">900</Money> </Amount > <!-- fee information, optional and not in credit memo --> <FeeAmount> <Money currency="USD">15.00</Money> <!-- total fee --> <Fee type="serviceProvider"> <Money currency="USD">5.00</Money> </Fee> <Fee type="community"> <Money currency="USD">5.00</Money> </Fee> <Fee type="funder"> <Money currency="USD">5.00</Money> </Fee> </FeeAmount> </TradeItem> <TradeItem lineNumber="2" paymentProposalID="PPR911"> maturityDate="2015-04-30T10:43:36-07:00"> <!-- credit memo --> <PayableInfo> <PayableInvoiceInfo> <InvoiceIDInfo invoiceDate="2015-03-30T10:43:36-07:00" invoiceID="cm123"></InvoiceIDInfo> </PayableInvoiceInfo> </PayableInfo> <OriginalAmount> <Money currency="USD">-100</Money> </OriginalAmount> <AdjustmentAmount> <Money currency="USD">-100.00</Money> <Modifications> <Modification>

394PUBLICPÚBLICO

Guía de soluciones cXMLNegociaciones de financiación de la cadena de suministro

Page 395: 355a de soluciones cXML - help.sap.com

<AdditionalDeduction type="creditApplied"> <DeductionAmount> <Money currency="USD">-100.00</Money> </DeductionAmount> </AdditionalDeduction> </Modification> </Modifications> </AdjustmentAmount> <DaysPaidEarly>0</DaysPaidEarly> <Amount> <Money currency="USD">0</Money> </Amount> </TradeItem> </TradeRequest>

Guía de soluciones cXMLNegociaciones de financiación de la cadena de suministro

PUBLICPÚBLICO 395

Page 396: 355a de soluciones cXML - help.sap.com

Transacción para obtener documentos pendientes/descargar datos

Los compradores y proveedores Ariba Network pueden recibir documentos de Ariba Network consultando acerca de ellos y descargándolos.

La mayoría de compradores y proveedores Ariba Network utilizan enrutamiento de cXML para impulsar la entrada de documentos en Internet a su aplicación cXML en la web. Opcionalmente, los compradores y los proveedores pueden utilizar la consulta y la descarga para recibir datos de Ariba Network. En el escenario de consulta, Ariba Network pone en cola los datos por tipo de documento para la descarga iniciada desde aplicaciones más tarde. El comprador de Ariba, las aplicaciones de compra ajenas a Ariba y los proveedores que han integrado sus cuentas Ariba Network con su sistema ERP externo mediante cXML también pueden recibir documentos de Ariba Network consultando y descargando.

Los usuarios utilizan la transacción cXML para obtener documentos pendientes (GetPendingRequest/GetPendingResponse) para consultar acerca de documentos pendientes. Utilizan la transacción para la descarga de datos cXML (DataRequest/DataResponse) para recuperar esos documentos.

NotaEn SAP Ariba Buying and Invoicing, Ariba Network envía el documento a SAP Ariba Buying and Invoicing comunicando el documento. Con la publicación del documento, los clientes pueden ver de inmediato confirmaciones de pedido, avisos de expedición, facturas y otros documentos enviados por proveedores. SAP Ariba Buying and Invoicing no utiliza las transacciones para obtener y descargar documentos cXML pendientes.

Frecuencia de consulta [página 396]

Hora de consulta [página 397]

Descarga de todos los documentos en espera [página 397]

Confirmar la recepción de documentos [página 397]

GetPendingRequest [página 398]

GetPendingResponse [página 400]

DataRequest [página 401]

DataResponse [página 401]

Frecuencia de consulta

Las aplicaciones de compras y proveedoras deberían consultar si hay documentos nuevos y descargarlos al menos una vez cada hora. También pueden consultar con una frecuencia superior a esta si hay documentos StatusUpdateRequest para los estados actuales de pedidos de compra.

396PUBLICPÚBLICO

Guía de soluciones cXMLTransacción para obtener documentos pendientes/descargar datos

Page 397: 355a de soluciones cXML - help.sap.com

Hora de consultaPara obtener una mejor respuesta de Ariba Network, las aplicaciones de compras y proveedoras deberían programar la consulta y la descarga con un desplazamiento temporal aleatorio desde la hora en punto. Así por ejemplo, si consulta y descarga una vez cada hora, seleccione una hora aleatoria entre 0 y 59 minutos después de la hora en punto (lo ideal es aleatorizar también los segundos).

La consulta y la descarga se pueden efectuar en el mismo momento cada hora, pero debe evitar fijarse cero o treinta minutos después de la hora. Esta técnica espacia la descarga para que todas las organizaciones compradoras y de proveedor no soliciten descargas al mismo tiempo.

Descarga de todos los documentos en esperaLa transacción para obtener documentos pendientes tiene un atributo maxMessages que permite a las aplicaciones de compras y de proveedor limitar el número de documentos devueltos por Ariba Network. Utilice este atributo para evitar interrupciones durante la descarga en Ariba Network o en aplicaciones de compras y de proveedor.

Si por ejemplo hay 99 documentos en espera, la aplicación de compras o de proveedor puede descargarlos en lotes de 20 (maxMessages="20"):

Interacción de consulta Documentos devueltos

get pending/data download 1 20

get pending/data download 2 20

get pending/data download 3 20

get pending/data download 4 20

get pending/data download 5 19

get pending 6 0

Cada vez que una aplicación de compras o de proveedor consulta y descarga debe vaciar por completo la cola de documentos pendientes en Ariba Network. Debe iniciar varias transacciones para obtener y descargar documentos pendientes hasta que Ariba Network indica que no hay más documentos en espera. No debe dejar de consultar y descargar tras alcanzar un número predeterminado de transacciones para obtener y descargar documentos pendientes.

Confirmar la recepción de documentosTras descargar documentos ConfirmationRequest, ShipNoticeRequest o InvoiceDetailRequest, las aplicaciones de compras deberían enviar documentos StatusUpdateRequest a Ariba Network para indicar que los han recibido. Las aplicaciones de proveedor también deben enviar los documentos StatusUpdateRequest a Ariba Network tras recibir los documentos.

Guía de soluciones cXMLTransacción para obtener documentos pendientes/descargar datos

PUBLICPÚBLICO 397

Page 398: 355a de soluciones cXML - help.sap.com

Si es preciso, el elemento Extrinsic puede utilizarse para obtener información adicional sobre el estado del documento que se está actualizando.

Las aplicaciones de compras no deberían enviar un documento StatusUpdateRequest para confirmar un documento StatusUpdateRequest, ya que esta acción podría dar lugar a confirmaciones circulares.

GetPendingRequestLas aplicaciones compradoras y proveedoras utilizan el documento cXML GetPendingRequest para consultar los documentos en espera en Ariba Network. Genere un documento GetPendingRequest para cada tipo de documento cXML que la aplicación compradora y proveedora pueda descargar.

Las aplicaciones compradoras y proveedoras pueden descargar estos documentos:

● StatusUpdateRequest ● ConfirmationRequest ● ShipNoticeRequest ● ServiceEntryRequest● InvoiceDetailRequest● SupplierChangeMessage● SalesOrderRequest● CopyRequest● PaymentProposalRequest● CopyRequest● PaymentRemittanceRequest● CopyRequest● PaymentRemittanceStatusUpdateRequest● SubscriptionChangeMessage● OrganizationChangeMessage

Los proveedores de Ariba Network deben configurar sus cuentas Ariba Network para recuperar documentos cXML a través de documentación pendiente mediante el método de transacción GetPending/Data Download. Para obtener más información consulte Configuración del enrutamiento de documentos en el centro de ayuda.

El siguiente ejemplo consulta los documentos cXML StatusUpdateRequest:

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd"><cXML payloadID="[email protected]" timestamp="2005-01-13T00:00:16+00:00"> <Header> <From> <Credential domain="NetworkID"> <Identity>AN13000000259</Identity> </Credential> </From> <To> <Credential domain="NetworkID"> <Identity>AN01000000001</Identity> </Credential> </To>

398PUBLICPÚBLICO

Guía de soluciones cXMLTransacción para obtener documentos pendientes/descargar datos

Page 399: 355a de soluciones cXML - help.sap.com

<Sender> <Credential domain="NetworkID"> <Identity>AN13000000259</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Our Procurement System 3.0</UserAgent> </Sender> </Header> <Request> <GetPendingRequest lastReceivedTimestamp="2005-01-12T00:00:25+00:00" maxMessages="20"> <MessageType>StatusUpdateRequest</MessageType> </GetPendingRequest> </Request> </cXML>

El atributo lastReceivedTimestamp [página 403] especifica el mensaje más antiguo que Ariba Network debe devolver. Utilice el atributo cXML timestamp del último documento GetPendingResponse recibido como el atributo lastReceivedTimestamp en el siguiente documento GetPendingRequest para ese tipo de documento. Cuando Ariba Network recibe un GetPendingRequest, descarta los mensajes en espera a los que se hace referencia en los documentos GetPendingResponse anteriores con marcas de tiempo iguales o anteriores a la lastReceivedTimestamp especificada.

El atributo maxMessages especifica el número máximo de documentos a devolver. Este documento ayuda a evitar interrupciones en las aplicaciones Ariba Network, compradoras o proveedoras si existen demasiados documentos en espera. Normalmente, debe utilizar un valor entre 10 y 100 para este atributo. Las aplicaciones compradoras y proveedoras siguen utilizando las transacciones para obtener documentos pendientes y descargar datos hasta que la cola de documentos en espera de Ariba Network se vacíe. Si la aplicación se interrumpe debido a tamaños de adjuntos demasiado grandes, limite el atributo maxMessages a un número inferior a 10, por ejemplo:

<GetPendingRequest lastReceivedTimestamp="2015-12-01T16:00:00-08:00" maxMessages="1"> <MessageType>InvoiceArchive<MessageType> </GetPendingRequest>

Si su organización está activada para varios sistemas ERP, puede incluir un SystemID que iguale una de sus cuentas ERP. Ariba Network busca y devuelve todos los documentos para el sistema ERP especificado. Si no se especifica un SystemID , Ariba Network devuelve los documentos para todas las cuentas ERP.

El siguiente ejemplo consulta los documentos cXML para una sola cuenta ERP:

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd"><cXML payloadID="[email protected]" timestamp="2005-01-13T00:00:16+00:00"> <Header> <From> <Credential domain="NetworkID"> <Identity>AN13000000259</Identity> </Credential> </From> <To> <Credential domain="SystemID"> <Identity>ERP01</Identity> </Credential> </To> <Sender> <Credential domain="NetworkID"> <Identity>AN13000000259</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential>

Guía de soluciones cXMLTransacción para obtener documentos pendientes/descargar datos

PUBLICPÚBLICO 399

Page 400: 355a de soluciones cXML - help.sap.com

<UserAgent>Our Procurement System 3.0</UserAgent> </Sender> </Header> <Request> <GetPendingRequest lastReceivedTimestamp="2005-01-12T00:00:25+00:00" maxMessages="20"> <MessageType>StatusUpdateRequest</MessageType> </GetPendingRequest> </Request> </cXML>

GetPendingResponse

Ariba Network devuelve un documento Response que contiene o no contiene un documento GetPendingResponse en la misma conexión HTTP. Si no hay ningún GetPendingResponse, no hay documentos en espera. Si hay un GetPendingResponse, hay documentos en espera.

El siguiente ejemplo indica que hay uno o varios documentos en espera:

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd"><cXML timestamp="2005-01-12T16:00:18-08:00" payloadID="[email protected]"> <Response> <Status code="200" text="OK"/> <GetPendingResponse> cXML timestamp="2005-01-12T16:00:18-08:00" payloadID="[email protected]"> <Header> <From> <Credential domain="NetworkID"> <Identity>AN01000000001</Identity> </Credential> </From> <To> <Credential domain="NetworkID"> <Identity>AN13000000259</Identity> </Credential> </To> <Sender> <Credential domain="NetworkID"> <Identity>AN01000000001</Identity> </Credential> <UserAgent>ANCXMLDispatcher</UserAgent> </Sender> </Header> <Message> <DataAvailableMessage> <InternalID domain="PendingMessages">3738</InternalID> </DataAvailableMessage> </Message> </GetPendingResponse> </Response> </cXML>

El elemento DataAvailableMessage contiene un ID interno que se corresponde con uno o varios documentos que están esperando a ser descargados.

400PUBLICPÚBLICO

Guía de soluciones cXMLTransacción para obtener documentos pendientes/descargar datos

Page 401: 355a de soluciones cXML - help.sap.com

DataRequestUna vez que las aplicaciones de compras y de proveedor obtienen un DataAvailableMessage, utilizan su valor de ID interno para descargar los documentos en espera enviando un documento cXML DataRequest.

NotaLa URL de Ariba Network para la recepción de documentos DataRequest es distinto de la URL para documentos GetPendingRequest; la única forma de obtenerlo es emitiendo un documento ProfileRequest [página 73].

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd"><cXML payloadID="[email protected]" timestamp="2005-01-13T00:00:21+00:00"> <Header> <From> <Credential domain="NetworkID"> <Identity>AN13000000259</Identity> </Credential> </From> <To> <Credential domain="NetworkID"> <Identity>AN01000000001</Identity> </Credential> </To> <Sender> <Credential domain="NetworkID"> <Identity>AN13000000259</Identity> <SharedSecret>abracadabra</SharedSecret> </Credential> <UserAgent>Our Procurement System 3.0</UserAgent> </Sender> </Header> <Request> <DataRequest> <InternalID domain="PendingMessages">3738</InternalID> </DataRequest> </Request> </cXML>

DataResponseAriba Network responde a la DataRequest cXML con un documento DataResponse y con los documentos solicitados incluidos todos en un sobre MIME utilizando la misma conexión HTTP. La cabecera HTTP Content-Type define el límite MIME.

El siguiente documento DataResponse tiene un documento StatusUpdateRequest adjunto.

Content-Type: multipart/mixed; boundary="----=_Part_0_10550230.1105574425445" ------=_Part_0_10550230.1105574425445Content-Type: text/xml; charset=UTF-8Content-ID: <[email protected]><?xml version="1.0" encoding="UTF-8"?>

Guía de soluciones cXMLTransacción para obtener documentos pendientes/descargar datos

PUBLICPÚBLICO 401

Page 402: 355a de soluciones cXML - help.sap.com

<!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd"><cXML timestamp="2005-01-12T16:00:25-08:00" payloadID="[email protected]"> <Response> <Status code="200" text="OK"/> <DataResponse> <Attachment> <URL>cid:[email protected]</URL> </Attachment> </DataResponse> </Response></cXML>------=_Part_0_10550230.1105574425445Content-Type: text/xml; charset=UTF-8Content-ID: <[email protected]><?xml version="1.0" encoding="UTF-8"?><!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd"><cXML payloadID="[email protected]" timestamp="2005-01-12T15:51:59-08:00"> <Header> <From> <Credential domain="NetworkID"> <Identity>AN12000000259</Identity> </Credential> </From> <To> <Credential domain="NetworkID"> <Identity>AN13000000259</Identity> </Credential> </To> <Sender> <Credential domain="NetworkID"> <Identity>AN01000000001</Identity> </Credential> <UserAgent>AN</UserAgent> </Sender> </Header> <Request deploymentMode="production"> <StatusUpdateRequest> <DocumentReference payloadID="[email protected]"/> <Status code="200" message="OK"/> </StatusUpdateRequest> </Request></cXML> ------=_Part_0_10550230.1105574425445--

DataResponse y archivos adjuntos de factura

Si las facturas tienen adjuntos, la DataResponse contiene adjuntos InvoiceDetailRequest que también tienen adjuntos. Ariba Network envía facturas con adjuntos en sobres MIME multinivel.

La descarga de adjuntos a facturas se puede configurar en cuentas de Ariba Network del comprador. Su activación afecta únicamente a facturas enviadas recientemente, no a las facturas en cola existentes.

402PUBLICPÚBLICO

Guía de soluciones cXMLTransacción para obtener documentos pendientes/descargar datos

Page 403: 355a de soluciones cXML - help.sap.com

lastReceivedTimeStamp y documentos en espera

Ariba Network borra los documentos referenciados de la cola de documentos en espera cuando recibe el siguiente GetPendingRequest para ese tipo de documento. Por lo tanto, las aplicaciones de compras y proveedoras no deben omitir los documentos en espera.

Tras enviar un documento DataRequest, deben recibir los documentos referenciados antes de enviar otro documento GetPendingRequest. Si los documentos DataRequest fallan, deberán volver a intentar la transacción. Si fallan de nuevo, deberán informar de ello al administrador de la aplicación de compras y proveedora.

Este es un ejemplo de cómo se utiliza el atributo lastReceivedTimestamp:

1. La aplicación de compras envía un GetPendingRequest:

<GetPendingRequest lastReceivedTimestamp="time1"/>

Ariba Network responde con

<cXML timestamp="time2"> <GetPendingResponse> <DataAvailableMessage> <InternalID domain="PendingMessages">id1</InternalID> </DataAvailableMessage> </GetPendingResponse> </cXML>

2. La aplicación de compras recupera los documentos en espera enviado un DataRequest:

<DataRequest> <InternalID domain="PendingMessages">id1</InternalID> </DataRequest>

Ariba Network responde con

<DataResponse>...</DataResponse>

En este punto, la aplicación de compras puede descargar id1 una y otra vez.3. Posteriormente, la aplicación de compras envía otro GetPendingRequest:

<GetPendingRequest lastReceivedTimestamp="time2"/

La aplicación de compras confirma la recepción de los documentos referenciados por el primer GetPendingResponse enviando el segundo GetPendingRequest. Ariba Network borra todos los documentos en espera asociados a id1 y la aplicación de compras ya no puede volver a descargar id1.Ariba Network responde con

<cXML timestamp="time3"> <GetPendingResponse> <DataAvailableMessage> <InternalID domain="PendingMessages">id2</InternalID> </DataAvailableMessage> </GetPendingResponse> </cXML>

En este punto, la aplicación de compras puede descargar iid2 una y otra vez.

Guía de soluciones cXMLTransacción para obtener documentos pendientes/descargar datos

PUBLICPÚBLICO 403

Page 404: 355a de soluciones cXML - help.sap.com

Autentificación de documentos en espera

Las aplicaciones de compras y de proveedor no necesitan autentificar documentos descargados mediante la transacción de descarga de datos, ya que proceden de una fuente de confianza, Ariba Network. Pueden validar el certificado de servidor TLS de Ariba Network cuando inician conexiones HTTPS.

404PUBLICPÚBLICO

Guía de soluciones cXMLTransacción para obtener documentos pendientes/descargar datos

Page 405: 355a de soluciones cXML - help.sap.com

SAP Ariba Supply Chain Collaboration

Esta extensión de Ariba Network proporciona funciones adicionales para compradores y proveedores.

Al activar SAP Ariba Supply Chain Collaboration, un conjunto de funciones se pone a disposición de compradores y proveedores en Ariba Network. Estas funciones facilitan la colaboración entre compradores y proveedores, por ejemplo, en transacciones relacionadas con la cadena de suministro de material directo.

Como comprador, la solución de SAP Ariba Supply Chain Collaboration permite hacer lo siguiente:

● Colaborar de forma eficiente con todos los interlocutores de la cadena de suministro mediante una única solución global.

● Mejorar la visibilidad del aprovisionamiento con una supervisión continuada, evaluación comparativa y mejora del rendimiento del proveedor.

● Gestionar fácilmente el aprovisionamiento de todos los materiales directos y los procesos colaborativos habituales de comercio y fabricación —incluidos inventario consignado, planes de entregas acumulados y fabricación a terceros— en un mismo lugar.

● Responder de forma inteligente a las modificaciones en el aprovisionamiento y la demanda con una visibilidad en tiempo real en la métrica de la cadena logística.

● Conectarse con rapidez a miles de proveedores con un coste mínimo en TI.● Identificar al instante errores mediante reglas empresariales configurables con validación y reconciliación

automáticas.

NotaLas funciones de SAP Ariba Supply Chain Collaboration incluyen mejoras en la interfaz de usuario de Ariba Network. Los campos y pestañas que no aparecen en la interfaz normal de Ariba Network pueden aparecer en la interfaz de usuario de SAP Ariba Supply Chain Collaboration. También, la misma pestaña puede etiquetarse con un nombre en la interfaz de usuario normal de Ariba Network y con otro nombre en la interfaz de usuario de SAP Ariba Supply Chain Collaboration. Los usuarios deben tener en cuenta estas diferencias, especialmente al cambiar de la interfaz de usuario normal de Ariba Network a la interfaz de usuario de SAP Ariba Supply Chain Collaboration.

Colaboración de consignación [página 405]

Escenarios empresariales y premisas para la previsión y el compromiso B2B [página 408]

Colaboración de consignación

Una venta por consignación significa que los bienes han sido enviados del proveedor al comprador, pero el proveedor conserva su propiedad hasta que el comprador paga por los bienes consignados que consume mediante un método de pedido de compra predefinido. Los bienes consignados depositados en los almacenes o centros de producción del comprador no se pagan hasta que se utilizan. La transferencia de la propiedad, y a menudo de la ubicación, al comprador en el momento que consume los bienes se denomina movimiento de consignación.

Guía de soluciones cXMLSAP Ariba Supply Chain Collaboration

PUBLICPÚBLICO 405

Page 406: 355a de soluciones cXML - help.sap.com

SAP Ariba Supply Chain Collaboration proporciona a los proveedores formas de visualizar una lista de materiales en consignación, a los proveedores de crear facturas por movimientos de consignación y a los compradores de crear facturas de autofacturación para movimientos de consignación.

Los siguientes elementos soportan la colaboración de inventario de consignación:

Elemento Contenido en Descripción

ProductActivityMessage n/a Transmite el inventario de componentes, el movi­miento de consignación e información de previsión desde el sistema ERP del comprador. La vista de re­sumen del inventario proporcionada por el compra­dor incluye los componentes declarados al proveedor. La información facilitada proporciona una instantá­nea del inventario de componentes y la situación de previsión en un determinado momento.

ProductActivityHeader ProductActivityMessage Contiene información sobre un inventario de compo­nentes en concreto, los detalles de previsión del pro­ducto o un movimiento de consignación para el pro­ducto.

ProductActivityDetails ProductActivityMessage Contiene los detalles sobre una actividad de pro­ducto.

Inventory ProductActivityDetails El inventario que está en posesión del comprador, que le pertenece y es gestionado por el comprador.

ConsignmentInventory ProductActivityDetails El inventario que está en posesión del comprador pero es propiedad del proveedor.

ConsignmentMovement ProductActivityDetails Contiene información sobre el movimiento de mate­riales desde el inventario de consignación al inventa­rio del comprador.

ProductMovementItem-IDInfo

ConsignmentMovement Una referencia al artículo en línea en un documento de movimientos.

InvoiceItemIDInfo ConsignmentMovement Artículo en línea de una factura creada por el compra­dor contra el artículo del movimiento.

Ejemplo ConsignmentMovement

El siguiente ejemplo muestra un ProductActivityMessage utilizado para comunicar el movimiento de material del inventario de consignación al inventario del comprador:

<ProductActivityMessage> <ProductActivityHeader messageID="PRO_ACT_1001" creationDate="2014-11-10T22:00:00-08:00"/> <ProductActivityDetails> <ItemID> <SupplierPartID>ZEEEA25</SupplierPartID> <BuyerPartID>REEEA25</BuyerPartID> </ItemID>

406PUBLICPÚBLICO

Guía de soluciones cXMLSAP Ariba Supply Chain Collaboration

Page 407: 355a de soluciones cXML - help.sap.com

<Description xml:lang="en">Movement of Consignment</Description> <Batch productionDate="2014-11-10T22:00:00-08:00" expirationDate="2014-12-10T22:00:00-08:00" originCountryCode="US"> <BuyerBatchID>BWWBRCA25</BuyerBatchID> <SupplierBatchID>SWWBRCA25</SupplierBatchID> <PropertyValuation> <PropertyReference> <IdReference identifier="CHEMICAL" domain="ID"/> <IdReference identifier="1" domain="VersionID"/> <IdReference identifier="MEDICINE_PROPERTIES" domain="PropertyDefinitionClassReferenceID"/> <IdReference identifier="1" domain="PropertyDefinitionClassReferenceVersionID"/> </PropertyReference> <ValueGroup> <IdReference identifier="2" domain="ID"/> </ValueGroup> </PropertyValuation> </Batch> <Contact role="locationTo"> <Name xml:lang="en">Palo Alto - Plant1</Name> <IdReference domain="buyerLocationID" identifier="0001"> <Description xml:lang="en">Sunnyvale Plant</Description > </IdReference> </Contact> <ConsignmentMovement> <ProductMovementItemIDInfo movementLineNumber="3" movementID="MADOC421304_r" movementDate="2015-03-10T11:00:00-08:00"/> <MovementQuantity quantity="200"> <UnitOfMeasure>TOK</UnitOfMeasure> </MovementQuantity> <SubtotalAmount> <Money currency="USD">2400</Money> </SubtotalAmount> <UnitPrice> <Money currency="USD">12</Money> </UnitPrice> </ConsignmentMovement> <ConsignmentMovement> <ProductMovementItemIDInfo movementLineNumber="4" movementID="MADOC421305_r" movementDate="2015-03-12T11:00:00-08:00"/> <MovementQuantity quantity="500"> <UnitOfMeasure>TOK</UnitOfMeasure> </MovementQuantity> <SubtotalAmount> <Money currency="USD">6000</Money> </SubtotalAmount> <UnitPrice> <Money currency="USD">12</Money> </UnitPrice> </ConsignmentMovement> <ConsignmentMovement> <ProductMovementItemIDInfo movementLineNumber="5" movementID="MADOC421306_r" movementDate="2015-03-14T11:00:00-08:00"/> <InvoiceItemIDInfo invoiceLineNumber="1" invoiceID="INVD1000" /> <MovementQuantity quantity="300"> <UnitOfMeasure>TOK</UnitOfMeasure> </MovementQuantity> <SubtotalAmount> <Money currency="USD">3600</Money> </SubtotalAmount> <UnitPrice> <Money currency="USD">12</Money> </UnitPrice> </ConsignmentMovement> </ProductActivityDetails> </ProductActivityMessage>

Guía de soluciones cXMLSAP Ariba Supply Chain Collaboration

PUBLICPÚBLICO 407

Page 408: 355a de soluciones cXML - help.sap.com

Escenarios empresariales y premisas para la previsión y el compromiso B2B A continuación, encontrará escenarios empresariales y premisas para la previsión y el compromiso.

Previsión

El mensaje de previsión siempre se considera la instantánea completa de un producto. La aparición de la misma combinación de producto y planta en el cxml sobrescribirá los datos anteriores del producto o planta.

Las previsiones consecutivas recibidas también se sobrescribirán si existe el mismo producto en el sistema.

La cantidad de previsión se sobrescribirá en la base de datos si el producto ya existe en la base de datos. Esto viene determinado por los siguientes factores:

● Si el ID de pieza de comprador, ID de pieza de proveedor y la planta coinciden con un registro existente.● Si el ID de pieza de comprador y la planta coinciden con un registro existente y el ID de pieza de proveedor es

diferente, éste se sobrescribirá.● Si el ID de pieza de proveedor y la planta coinciden con un registro existente en el que el ID de pieza de

comprador es nulo y el producto actual tiene el ID de pieza de comprador, el ID de pieza de comprador se actualizara con el mismo registro.

Si el producto no existe en el sistema, se creará un nuevo registro en la base de datos. Esto viene determinado por los siguientes factores:

● Si el ID de pieza de comprador no coincide con el registro actual.● Si la planta no coincide con el registro actual.

Los datos de previsión se sobrescribirán a partir de la fecha actual o a partir de la fecha más temprana que aparezca en el cxml. Esto significa que se mantendrán los datos anteriores y todas las cantidades futuras se fijarán en cero.

Si aparece la misma fecha para un producto en los detalles de producto, se agregarán las cantidades.

El calendario Java se tiene en cuenta para todos los cálculos de fecha.

Para una agregación por semana, la semana se considera que abarca de lunes a domingo.

El calendario Java incluirá los últimos días del año en la primera semana del año siguiente en los casos en que el año tenga más de 52 semanas.

Para realizar un cálculo diario, sólo se tendrá en cuenta la fecha y se ignorará la marca de tiempo y la zona horaria.

La sobrescritura o actualización de la previsión se realiza trasladando la cantidad de previsión existente a la columna de cambio y trasladando la cantidad actual a la columna de cantidad de previsión.

Si un documento de previsión tiene una fecha de inicio vacía, todos los datos de previsión de ese producto, pasados y presentes, se eliminarán. Sin embargo, el producto seguirá presente en el sistema.

408PUBLICPÚBLICO

Guía de soluciones cXMLSAP Ariba Supply Chain Collaboration

Page 409: 355a de soluciones cXML - help.sap.com

Compromiso

El mensaje de compromiso se gestiona de forma similar al documento de previsión.

El mensaje de compromiso también se considera la instantánea completa de un producto.

Un mensaje de compromiso consecutivo sobrescribirá las cantidades de ventaja y compromiso del producto.

La actualización se realiza en base a lo siguiente. Compruebe si el producto existe en el sistema:

● Si el ID de pieza de comprador, ID de pieza de proveedor y la planta coinciden con un registro existente.● Si el ID de pieza de comprador y la planta coinciden con un registro existente y el ID de pieza de proveedor es

diferente, éste se sobrescribirá.

En ningún caso se trata de un nuevo registro creado por un mensaje de compromiso. Esto significa que las cantidades de compromiso se guardarán en el sistema sólo si existe una previsión para ese producto.

Las reglas de la fecha y el calendario de compromiso son similares a las de la fecha y el calendario de previsión.

Si un documento de compromiso tiene una fecha de inicio vacía, los datos de compromiso se suprimirán a partir de la fecha actual o de la fecha más temprana del cxml. Los datos de previsión no se suprimirán.

Guía de soluciones cXMLSAP Ariba Supply Chain Collaboration

PUBLICPÚBLICO 409

Page 410: 355a de soluciones cXML - help.sap.com

Contratos

Si SAP Ariba Contracts está integrado con SAP ERP, los usuarios pueden enviar artículos del documento de artículos en línea y campos de cabecera de proyecto de un área de trabajo de contrato de conformidad a ERP.

Cuando un usuario selecciona la opción Enviar a un sistema externo en un menú de documentos de artículos en línea, SAP Ariba Contracts envía los artículos en línea y la información de los campos de cabecera de proyecto al ERP. La información se envía en un documento cXML Contract Request a Ariba Network, y Ariba Network reenvía la solicitud a ERP. ERP devuelve la información de estado en un documento cXML Contract Status Update Request a Ariba Network, y Ariba Network reenvía la solicitud a SAP Ariba Contracts.

ContractRequest [página 410]

ContractStatusUpdateRequest [página 415]

ContractRequestSAP Ariba envía un documento de ContractRequest a SAP ERP cuando un usuario selecciona Enviar a un sistema externo del menú de un documento de artículos en línea de contrato. La opción de menú Enviar a un sistema externo está disponible cuando el documento de artículos en línea y el área de trabajo se publican.

Un documento ContractRequest contiene información de la cabecera de área de trabajo de contrato y el contenido del documento de artículos en línea, incluido el elemento type, que especifica el tipo de documento de contrato SAP que se creará (contrato por valor o contrato por cantidad). El valor del elemento type viene determinado por el campo Categoría de documento del área de trabajo de contrato.

operation en un documento ContractRequest es new la primera vez que el documento de artículos en línea se envía a ERP. Si ERP procesa correctamente ContractRequest, ERP devuelve un documento ContractStatusUpdateRequest con los elementos StatusSucceeded y IDReference con el ID del documento de contrato SAP y los números de línea correspondientes.

Si el documento de artículos en línea ya se ha enviado a SAP ERP y el usuario vuelve a enviar el documento, operation es update. SAP Ariba envía ReferenceDocumentInfo con valores de los elementos IDReference de ContractStatusUpdateRequest para identificar artículos en línea y el documento de contrato SAP.

ContractRequest con condiciones de determinación de precios

Un documento cXML ContractRequest puede contener condiciones de determinación de precios para los artículos en línea. Las condiciones de determinación de precios se pueden definir dentro de un elemento intrínseco o un elemento extrínseco en el documento cXML ContractRequest.

Puede integrar un documento cXML ContractRequest que contiene condiciones de determinación de precios como un acuerdo marco (contrato) entre SAP Ariba Sourcing o SAP Ariba Contracts y SAP ERP a través de SAP

410PUBLICPÚBLICO

Guía de soluciones cXMLContratos

Page 411: 355a de soluciones cXML - help.sap.com

Ariba Cloud Integration Gateway mediante el elemento intrínseco PricingConditions o el elemento extrínseco AdvancedPriceConditions.

Para obtener más información, consulte la sección Acerca de las condiciones de determinación de precios en SAP RFQ y la integración de la adjudicación con SAP Ariba Sourcing en la guía RFQ e integración de adjudicación con SAP Ariba Sourcing.

Artículos de servicio de SAP

Un documento ContractRequest puede contener datos que SAP utiliza para crear artículos de servicio de SAP (artículos de la categoría de artículo de SAP D) que tienen una jerarquía de un nivel.

SAP Ariba envía una pareja de ContractItemIn superior y una ContractItemIn inferior para cada artículo en línea de contrato con el término Item Category fijado en D (servicios). Un elemento ContractItemIn secundario se vincula con el elemento ContractItemIn principal utilizando el atributo parentLineNumber en el elemento ItemIn; el elemento ContractItemIn con el atributo lineNumber coincidente en su elemento ItemIn es el principal.

El elemento ItemIn de un elemento ContractItemIn para un artículo en línea de servicio también contiene un atributo ItemClassification fijado en service.

El elemento ItemDetail para un artículo en línea de servicio incluye un elemento Classification; el atributo y el valor domain del elemento Classification se asignan a un dominio y un valor de código de mercancía Soluciones de SAP Ariba Strategic Sourcing.

Ejemplo

<Request deploymentMode="production"> <ContractRequest> <ContractRequestHeader operation="new" xml:lang="en" expirationDate="2016-01-30T00:00:00-00:00" effectiveDate="2016-01-11T00:00:00-00:00" type="value" agreementDate="2016-01-12T00:00:00-00:00" createDate="2016-01-11T23:36:18+08:00" contractID="CW2009"> <LegalEntity domain="CompanyCode">100</LegalEntity> <OrganizationID> <Credential domain="NetworkID"> <Identity>AN02000000120</Identity> </Credential> <Credential domain="sap"> <Identity>0000000100</Identity> </Credential> </OrganizationID> <OrganizationalUnit domain="PurchasingOrganization"> 1001 </OrganizationalUnit> <OrganizationalUnit domain="PurchasingGroup"> 10101 </OrganizationalUnit>

Guía de soluciones cXMLContratos

PUBLICPÚBLICO 411

Page 412: 355a de soluciones cXML - help.sap.com

<PaymentTerm payInNumberOfDays="10"> <Discount> <DiscountPercent percent="2"></DiscountPercent> </Discount> <Extrinsic name=”Id”>0001</Extrinsic> </PaymentTerm> <MaxAmount> <Money currency="USD">2000.00</Money> </MaxAmount> <TermsOfDelivery> <TermsOfDeliveryCode value="TransportCondition"/> <ShippingPaymentMethod value ="Other"/> <TransportTerms value="FOB">Free on board vessel</TransportTerms> </TermsOfDelivery> </ContractRequestHeader> <ContractItemIn> <TermsOfDelivery> <TermsOfDeliveryCode value="TransportCondition"/> <ShippingPaymentMethod value ="Other"/> <TransportTerms value="FOB">Free on board vessel</TransportTerms> </TermsOfDelivery> <ItemIn lineNumber="1" quantity="100" itemClassification=”material”> <ItemID> <SupplierPartID>1</SupplierPartID> <SupplierPartAuxiliaryID></SupplierPartAuxiliaryID> <BuyerPartID>992</BuyerPartID> <!-- Material code --> </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">1000.00</Money> <Modifications> <Modification> <AdditionalDeduction type="DISCOUNT"> <DeductionAmount> <Money currency="USD">10.00</Money> </DeductionAmount> </AdditionalDeduction> </Modification> <Modification> <AdditionalDeduction type="DISCOUNT"> <DeductionPercent percent="20"/> </AdditionalDeduction> </Modification> <Modification> <AdditionalCost> <Money currency="USD">30.00</Money> </AdditionalCost> </Modification> <Modification> <AdditionalCost> <Percentage percent="20"/> </AdditionalCost> </Modification> </Modifications> </UnitPrice> <Description xml:lang="en">Laptops</Description> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="unspsc">43211503</Classification> <Classification domain="MaterialGroup">29</Classification> <ManufacturerPartID></ManufacturerPartID> <ManufacturerName></ManufacturerName> <URL></URL> <LeadTime>2</LeadTime> </ItemDetail> <ShipTo> <Address addressID="3000" addressIDDomain="buyerLocationID"

412PUBLICPÚBLICO

Guía de soluciones cXMLContratos

Page 413: 355a de soluciones cXML - help.sap.com

isoCountryCode="US"> <Name xml:lang="en" >Plant 3000</Name> </Address> </ShipTo> </ItemIn> <ReferenceDocumentInfo lineNumber = "10"> <DocumentInfo documentID = "PR1234" documentType = "Requisition" documentDate = "2015-11-07T07:03:34-05:00"> </DocumentInfo> </ReferenceDocumentInfo> <ReferenceDocumentInfo lineNumber = "3"> <DocumentInfo documentID = "RFQ2345" documentType = "RFQ" documentDate = "2015-11-07T07:03:34-05:00"> </DocumentInfo> </ReferenceDocumentInfo> </ContractItemIn> </ContractRequest> </Request>

ContractRequestHeader

ContractRequestHeader es el elemento de cabecera para ContractRequest. Tiene los atributos siguientes:

Atributo Descripción

contractID(obligatorio)

ID de contrato SAP Ariba Contracts para esta solicitud.

type Identifica si el contrato está basado en valores o en cantidad. Los valores posibles son "value" o "quantity".

createDate La fecha y hora en que se ha creado el área de trabajo de contrato.

agreementDate Fecha del acuerdo para el área de trabajo.

effectiveDate (obligatorio) Fecha efectiva del área de trabajo.

expirationDate Fecha de expiración del área de trabajo.

xml:lang(obligatorio)

El idioma o configuración local en la que se escribe el contenido de ContractRequest.

operation El modo de operación de ContractRequest. Los valores posibles son:

● new: identifica una nueva transacción del contrato.● update: identifica la actualización de una transacción existente. El elemento

DocumentInfo se utiliza para indicar el contrato en el sistema externo.

ContractRequestHeader tiene los siguientes elementos:

Elemento Descripción

LegalEntity(obligatorio)

Una entidad legal en ERP. Tiene un elemento IdReference.

Guía de soluciones cXMLContratos

PUBLICPÚBLICO 413

Page 414: 355a de soluciones cXML - help.sap.com

Elemento Descripción

OrganizationID(obligatorio)

Proporciona las credenciales del ID de organización.

OrganizationalUnit Identifica la unidad de compras o grupo de compras en ERP. Tiene un elemento IdReference.

PaymentTerm Define una condición de pago en una factura o pedido. La condición de pago puede ser una condición de pago neta (sin descuento) o una condición de descuento (con descuento).

QuoteRequestReference Referencia a una solicitud de oferta originada en ERP.

MaxAmount El importe máximo del contrato.

MinAmount El importe mínimo del contrato.

MaxReleaseAmount La cantidad máxima contractual por versión de un contrato

MinReleaseAmount La cantidad mínima contractual por versión de un contrato

Contact Proporciona información de dirección o ubicación para la empresa que realiza la soli­citud.

Comments Comentarios adicionales sobre la solicitud de contrato.

DocumentInfo ID de contrato gestionado en ERP. Se incluye si la operación es "update".

ParentContractInfo ID de contrato principal de ERP si el contrato actual forma parte de una jerarquía.

TermsOfDelivery Condiciones opcionales de expedición (incoTerms) como las define la Cámara de Co­mercio Internacional.

Extrinsic Información adicional sobre la cabecera de solicitud de contrato.

ContractItemIn

ContractItemIn representa un artículo en línea de contrato que se debe enviar a ERP. Tiene los elementos siguientes:

Elemento Descripción

MaxAmount El importe máximo de un artículo.

MinAmount El importe mínimo de un artículo.

MaxReleaseAmount La cantidad contractual máxima de un artículo por versión (pedido).

MinReleaseAmount La cantidad contractual mínima de un artículo por versión (pedido).

MaxQuantity La cantidad máxima de un artículo.

MinQuantity La cantidad mínima de un artículo.

MaxReleaseQuantity La cantidad contractual máxima de un artículo por versión (pedido).

MinReleaseQuantity La cantidad contractual mínima de un artículo por versión (pedido).

414PUBLICPÚBLICO

Guía de soluciones cXMLContratos

Page 415: 355a de soluciones cXML - help.sap.com

Elemento Descripción

TermsOfDelivery Condiciones opcionales de expedición (incoTerms) como las define la Cámara de Co­mercio Internacional.

ItemIn(obligatorio)

Un artículo del sistema de la fuente de datos del comprador.

ReferenceDocumentInfo Información del documento de referencia opcional para este artículo en línea. Por ejemplo, la solicitud o RFQ de ERP.

ContractStatusUpdateRequestSAP ERP envía un documento ContractStatusUpdateRequest después de recibir una ContractRequest de SAP Ariba.

El documento ContractStatusUpdateRequest contiene el elemento Status, que indica si el sistema ERP ha creado o actualizado correctamente un documento de contrato correspondiente. También contiene elementos IDReference en los elementos ContractIDInfo y ContractItemStatus para identificar el documento y los artículos correspondientes en el sistema ERP.

Ejemplo

<Request deploymentMode="production"> <ContractStatusUpdateRequest> <Status xml:lang="en-US" code="200” text="OK">Succeeded</Status> <ContractStatus type="created"> <ContractIDInfo contractID="CW2009"> <IdReference identifier="55000000" domain="SAPAgreementId"/> </ContractIDInfo> <ContractItemStatus> <ItemStatus type="created"> <ReferenceDocumentInfo lineNumber="1"/> </ItemStatus> <IdReference identifier="010" domain="SAPLineNumber"/> </ContractItemStatus> <ContractItemStatus> <ItemStatus type="created"> <ReferenceDocumentInfo lineNumber="2"/> </ItemStatus> <IdReference identifier="020" domain="SAPLineNumber"/> </ContractItemStatus> </ContractStatus> </ContractStatusUpdateRequest> </Request>

Guía de soluciones cXMLContratos

PUBLICPÚBLICO 415

Page 416: 355a de soluciones cXML - help.sap.com

Estado

Estado de una respuesta o mensaje. Tiene los atributos siguientes:

Atributo Descripción

code(obligatorio)

Código de estado específico de HTTP o cXML.

text(obligatorio)

Versión textual del código de estado.

xml:lang El idioma o configuración local en la que se escribe el contenido de ContractStatusUpdateRequest.

ContractStatus

ContractStatus contiene actualizaciones de estado a nivel de artículo de un contrato. Contiene el siguiente atributo:

Atributo Descripción

type(obligatorio)

Tipo de estado del contrato (por ejemplo, "created").

ContractStatus tiene los siguientes elementos:

Elemento Descripción

ContractIDInfo(obligatorio)

Información del ID de contrato creado/actualizado en el sistema del comprador de origen.

ContractItemStatus Representa un artículo en línea en una solicitud de actualización de estado de con­trato.

Comments Campo opcional para notificar comentarios o alguna descripción de un artículo.

416PUBLICPÚBLICO

Guía de soluciones cXMLContratos

Page 417: 355a de soluciones cXML - help.sap.com

Tranformaciones cXML en Ariba Network

Cuando Ariba Network enruta documentos cXML OrderRequest o PunchOutSetupRequest de organizaciones compradoras a proveedores, puede llevar a cabo transformaciones que resuelvan problemas semánticos habituales. Estas transformaciones son necesarias porque las instalaciones Ariba Buyer pueden utilizar extrínsecos para especificar datos utilizados habitualmente, por ejemplo direcciones.

Para que resulten más útiles para los proveedores, estos datos deberían aparecer en elementos cXML dedicados, no en elementos extrínsecos. Por este motivo, Ariba Network puede convertir extrínsecos de cliente en extrínsecos estándar de Ariba Network, lo cual permite a los proveedores una integración más fácil con múltiples clientes.

Activación de transformaciones [página 417]

Desplazamiento de extrínsecos al elemento Contact [página 417]

Transformación de extrínsecos ItemOut [página 419]

Consolidación de ItemOut en OrderRequestHeader [página 419]

Asignación de extrínsecos personalizados a extrínsecos de Ariba Network [página 420]

Asignación de extrínsecos de cXML a EDI [página 420]

Activación de transformacionesLos proveedores pueden activar transformaciones según cada cliente haciendo clic en Transformación cXML/EDI en el área Relaciones con los clientes de sus cuentas.

Los proveedores pueden activar transformaciones por separado para OrderRequest y PunchOutSetupRequest. Tenga en cuenta que los controles de transformación no están disponibles en las páginas principales Enrutamiento de pedidos; sólo lo están en la página Transformación cXML/EDI. Estas transformaciones se describen más abajo.

Desplazamiento de extrínsecos al elemento ContactSi activa transformaciones OrderRequest, Ariba Network desplaza la información de contacto desde distintos extrínsecos al elemento Contact.

1. Los nombres se desplazan desde distintos extrínsecos al elemento Name.

<Extrinsic name="Name" <Extrinsic name="Requester" <Extrinsic name="RequesterName" <Extrinsic name="Requisition.Requester.Name"> <Extrinsic name="BuyerName" <Extrinsic name="OriginalRequester"

Guía de soluciones cXMLTranformaciones cXML en Ariba Network

PUBLICPÚBLICO 417

Page 418: 355a de soluciones cXML - help.sap.com

Ariba Network desplaza los datos anteriores a:

<Contact><Name>

2. Las direcciones se desplazan desde extrínsecos al elemento PostalAddress.

<Extrinsic name="Street" <Extrinsic name="City" <Extrinsic name="State" <Extrinsic name="Country" <Extrinsic name="isoCountryCode"

Ariba Network desplaza los datos anteriores a:

<Contact> <PostalAddress> <Street> <City> <State> <Country isoCountryCode> </Contact>

Un extrínseco Street de varias líneas se convierte en un elemento Street de varias líneas; no se transforma en elementos Street distintos para cada línea.

3. La información Entregar a se desplaza desde distintos extrínsecos al elemento DeliverTo dentro de PostalAddress.

<Extrinsic name="DeliverTo" <Extrinsic name="MailStop" <Extrinsic name="PoleNumber"

Ariba Network desplaza los datos anteriores a:

<Contact><PostalAddress><DeliverTo>...

4. El número de teléfono se desplaza desde distintos extrínsecos al elemento Phone.

<Extrinsic name="Phone" <Extrinsic name="Buyer Phone" <Extrinsic name="Requester Phone Number"

Ariba Network desplaza los datos anteriores a:

<Contact><Phone>...

5. El número de fax se desplaza desde un extrínseco al elemento Fax.

<Extrinsic name="Fax">

Ariba Network desplaza los datos anteriores a:

<Contact><Fax>...

6. La dirección de correo electrónico se desplaza desde un extrínseco al elemento Email.

<Extrinsic name="EmailAddress">

418PUBLICPÚBLICO

Guía de soluciones cXMLTranformaciones cXML en Ariba Network

Page 419: 355a de soluciones cXML - help.sap.com

Ariba Network desplaza los datos anteriores a:

<Contact><Email>...

Transformación de extrínsecos ItemOutSi activa las transformaciones OrderRequest o PunchOutSetupRequest, Ariba Network desplaza datos de elementos ItemOut Extrinsic a elementos intrínsecos.

1. El ID de solicitud se desplaza desde distintos extrínsecos al atributo requisitionID.

<ItemOut> <Extrinsic name="ReqNumber">value</Extrinsic> <Extrinsic name="Requisition #">value</Extrinsic> <Extrinsic name="PR No.">value</Extrinsic> <Extrinsic name="Requisition.PR">value</Extrinsic> <Extrinsic name="No.">value</Extrinsic>

Ariba Network desplaza estos datos de extrínsecos a:

<ItemOut requistionID="value">...

Si hay varios extrínsecos de ID de solicitud, Ariba Network desplaza únicamente el último a requisitionID.2. La URL se desplaza de un extrínseco al elemento URL.

<Extrinsic name="URL">

Ariba Network desplaza los datos anteriores a:

<URL>...

3. La fecha de expedición solicitada se desplaza desde distintos extrínsecos al atributo requestedDeliveryDate en el elemento ItemOut.

<ItemOut> <Extrinsic name="ETA">value</Extrinsic> <Extrinsic name="RequestedShipDate">value</Extrinsic> <Extrinsic name="RequestedDeliveryDate">value</Extrinsic> . . . </ItemOut>

Ariba Network desplaza estos datos de extrínsecos a:

<ItemOut requestedDeliveryDate="value">

Consolidación de ItemOut en OrderRequestHeaderSi activa transformaciones OrderRequest, Ariba Network reduce la redundancia consolidando la información del artículo en línea duplicada en el elemento OrderRequestHeader.

Guía de soluciones cXMLTranformaciones cXML en Ariba Network

PUBLICPÚBLICO 419

Page 420: 355a de soluciones cXML - help.sap.com

1. Si hay elementos Extrinsec idénticos dentro de cada ItemOut, Ariba Network los borra y crea un único Extrinsic en el nivel OrderRequestHeader. Si sólo hay un ItemOut, Ariba Network desplaza cualquier elemento Extrinsic dentro de él al nivel OrderRequestHeader.

2. Si hay elementos Contact idénticos dentro de cada ItemOut, Ariba Network los borra y crea un único Contact en el nivel OrderRequestHeader.

3. Si hay atributos requisitionID idénticos dentro de cada ItemOut, Ariba Network los borra y crea un único requisitionID en el nivel OrderRequestHeader.

Asignación de extrínsecos personalizados a extrínsecos de Ariba NetworkSi activa Asignar extrínsecos específicos de cliente a extrínsecos Ariba Network estándar, Ariba Network cambia los extrínsecos personalizados por extrínsecos Ariba Network estándar en pedidos de compra, lo cual le permite integrarse más fácilmente con varios clientes.

NotaEste control sólo está disponible si las organizaciones compradoras definen asignaciones en Ariba Network para cambiar extrínsecos personalizados por extrínsecos estándar. Estas deben ponerse en contacto con Global Services Organization (GSO) de SAP Ariba para definir esas asignaciones.

Ariba Network tiene una lista de unos 1500 extrínsecos Ariba Network estándar que abarcan conceptos como “cuenta de facturación”, “ID de hipoteca”y “número de registro.” Puede asignar extrínsecos personalizados de organizaciones compradoras a estos extrínsecos estándar cuando enruta pedidos de compra. Consulte la documentación Ariba Network para ver la lista de extrínsecos Ariba Network estándar.

Por ejemplo, Ariba Network puede cambiar el extrínseco personalizado

<Extrinsic name="Loan Number">1234</Extrinsic>

al extrínseco Ariba Network estándar

<Extrinsic name="mortgageIdNumber">1234</Extrinsic>

De forma predeterminada este control está desactivado, de modo que los proveedores reciben extrínsecos en el preciso momento en que las organizaciones compradoras los envían en pedidos de compra.

Asignación de extrínsecos de cXML a EDISi activa Asignar extrínsecos Ariba Network estándar a segmentos ANSI X12 REF, Ariba Network asigna datos de extrínsecos Ariba Network estándar a segmentos X12 REF en pedidos de compra.

Si las organizaciones compradoras utilizan extrínsecos Ariba Network estándar en pedidos de compra o asignan extrínsecos personalizados a extrínsecos Ariba Network estándar en pedidos de compra, Ariba Network convierte

420PUBLICPÚBLICO

Guía de soluciones cXMLTranformaciones cXML en Ariba Network

Page 421: 355a de soluciones cXML - help.sap.com

esos extrínsecos en elementos X12 REF equivalentes. Consulte la documentación Ariba Network para ver la lista de extrínsecos Ariba Network estándar.

De forma predeterminada este control está desactivado, de modo que Ariba Network asigna datos extrínsecos a elementos EDI en pedidos de compra.

Guía de soluciones cXMLTranformaciones cXML en Ariba Network

PUBLICPÚBLICO 421

Page 422: 355a de soluciones cXML - help.sap.com

Sistemas de codificación recomendados

Las aplicaciones de SAP Ariba utilizan sistemas de codificación estándar para las mercancías, la divisa, la unidad de medida, el país, el idioma y los códigos de marcación telefónicos.

Códigos de mercancía [página 422]

Códigos de divisa [página 423]

Códigos de unidad de medida [página 423]

Códigos de estado y país [página 424]

Códigos de idioma [página 426]

Códigos de marcación [página 427]

Códigos de mercancíaLa norma United Nations Standard Products and Services Code (UNSPSC) es el sistema de codificación de mercancías preferido de SAP Ariba. UNSPSC es gratuita y contiene descripciones de más de 12.000 productos y servicios.

La estructura de codificación de UNSPSC es jerárquica. Combina artículos similares en grupos estándar. Cuanto más nítida sea la granularidad de la descripción del artículo, más dígitos habrá en el código UNSPSC (hasta un total de 8 dígitos).

Dos organizaciones gestionan la clasificación UNSPSC:

● Electronic Commerce Code Management Association (ECCMA). Para obtener una lista de códigos, vaya a:https://www.eccma.org/unspsc

● United Nations Development Programme (UNDP). Para obtener una lista de códigos, vaya a:http://www.unspsc.org

Los códigos USPSC utilizan un punto para separar cada dos dígitos (por ejemplo 44.12.21.04), pero cXML requiere códigos sin ningún tipo de puntuación (por ejemplo, 44122104).

Ejemplos

Código Significado

44122104 Clips

22101522 Bulldozers de seguimiento

82111502 Servicios de escritura manual

422PUBLICPÚBLICO

Guía de soluciones cXMLSistemas de codificación recomendados

Page 423: 355a de soluciones cXML - help.sap.com

Códigos de divisaEspecifique los nombres de divisa con los códigos de divisa de tres letras de ISO 4217 (CodeA).

Para obtener una lista de códigos de divisa ISO 4217, vaya a:

http://www.currency-iso.org/en/home/tables/table-a1.html

Haga clic en Tabla A.1 (XLS) para descargar un archivo de Microsoft Excel con los códigos de divisa.

Ejemplos

Código Significado

BRL Real brasileño

JPY Yen japonés

USD Dólar estadounidense

Códigos de unidad de medidaEspecifique la cantidad de artículos que se empaquetan con el sistema de código común United Nations Units of Measure (UNUOM).

Este estándar también se conoce cómo:

● Códigos United Nations Center for the Facilitation of Procedure and Practices for Administration, Commerce, and Transport (UN/CEFACT)

● Códigos comunes United Nations Trade Data Elements Directory (UNTDED)● United Nations Economic Commission for Europe (UN/ECE) Trade Facilitation Recommendation 20: Códigos

para las unidades de medida utilizadas en el comercio internacional

Para obtener una lista de códigos, vaya a:

https://www.unece.org/cefact/codesfortrade/codes_index.html

Ejemplos

Código Significado

AY Montaje

BX Caja

Guía de soluciones cXMLSistemas de codificación recomendados

PUBLICPÚBLICO 423

Page 424: 355a de soluciones cXML - help.sap.com

Código Significado

DZN Docena

Códigos de estado y paísEspecifique los códigos de estado y país con el formato XX-YY(Y). XX es el código de país e YY(Y) es el código de estado (que puede ser de 2 o 3 bytes).

Para obtener una lista de códigos de país, consulte:

https://www.iso.org/iso-3166-country-codes.html

Ejemplos

Código Significado

BR Brasil

JP Japón

US Estados Unidos

Para obtener una lista de códigos de estado (y región), consulte:

http://www.unece.org/cefact/locode/subdivisions.html

Advertencia: Hemos aplicado algunas variaciones de la lista UNECE. Para obtener una lista de desviaciones, consulte la tabla siguiente.

Tabla 12:

Código Nombre de estado/región País

FR-ARA Auvernia-Ródano-Alpes FR

FR-BFC Borgoña-Franco Condado FR

FR-BRE Bretaña FR

FR-CVL Centro-Valle de Loira FR

FR-COR Córcega FR

FR-GES Gran Este FR

FR-GUA Guadalupe FR

FR-HDF Alta Francia FR

FR-IDF Isla de Francia FR

FR-MAY Mayotte FR

FR-NOR Normandía FR

FR-NAQ Nueva Aquitania FR

FR-OCC Occitania FR

424PUBLICPÚBLICO

Guía de soluciones cXMLSistemas de codificación recomendados

Page 425: 355a de soluciones cXML - help.sap.com

Código Nombre de estado/región País

FR-PDL Países del Loira FR

FR-PAC Provenza-Alpes-Costa Azul FR

FR-LRE La Réunion FR

BD-A Barisal BD

BD-B Chittagong BD

BD-C Dhaka BD

BD-D Khulna BD

BD-E Rajshahi BD

BD-F Rangpur BD

BD-G Sylhet BD

BD-H Mymensingh BD

CN-AH Anhui Sheng CN

CN-BJ Beijing Shi CN

CN-CQ Chongqing Shi CN

CN-FJ Fujian Sheng CN

CN-GD Guangdong Sheng CN

CN-GS Gansu Sheng CN

CN-GX Guangxi Zhuangzu Zizhiqu CN

CN-GZ Guizhou Sheng CN

CN-HA Henan Sheng CN

CN-HB Hubei Sheng CN

CN-HE Hebei Sheng CN

CN-HI Hainan Sheng CN

CN-HK Hong Kong, SAR CN

CN-HL Heilongjiang Sheng CN

CN-HN Hunan Sheng CN

CN-JL Jilin Sheng CN

CN-JS Jiangsu Sheng CN

CN-JX Jiangxi Sheng CN

CN-LN Liaoning Sheng CN

CN-MO Macao, SAR CN

CN-NM Mongolia interior CN

CN-NX Ningxia Huizi Zizhiqu CN

CN-QH Qinghai Sheng CN

CN-SC Sichuan Sheng CN

Guía de soluciones cXMLSistemas de codificación recomendados

PUBLICPÚBLICO 425

Page 426: 355a de soluciones cXML - help.sap.com

Código Nombre de estado/región País

CN-SD Shandong Sheng CN

CN-SH Shanghai Shi CN

CN-SN Shaanxi Sheng CN

CN-SX Shanxi Sheng CN

CN-TJ Tianjin Shi CN

CN-TW Taiwan Sheng CN

CN-XJ Xinjiang Uygur Zizhiqu CN

CN-XZ Xizang Zizhiqu CN

CN-YN Yunnan Sheng CN

CN-ZJ Zhejiang Sheng CN

ES-CB Cantabria ES

ES-IB Islas Baleares ES

FJ-C Central FJ

FJ-E Oriental FJ

FJ-N Norte FJ

FJ-W Occidental FJ

FJ-R Rotuma FJ

NO-50 Trøndelag NO

SZ-HH Hhohho SZ

SZ-LU Lubombo SZ

SZ-MA Manzini SZ

SZ-SH Shiselweni SZ

UG-214 Mayuge UG

UG-322 Agago UG

UG-323 Alebtong UG

UG-324 Amudat UG

Códigos de idiomaEspecifican nombres de idioma con códigos Java de configuración local.

Para obtener una lista de códigos, vaya a:

https://www.oracle.com/technetwork/java/javase/documentation/java11locales-5069639.html

426PUBLICPÚBLICO

Guía de soluciones cXMLSistemas de codificación recomendados

Page 427: 355a de soluciones cXML - help.sap.com

Java utiliza una barra baja (_) en los códigos, pero cXML utiliza un guion (-). Ejemplos:

Ejemplos

Código Significado

pt-BR Portugués (Brasil)

ja-JP Japonés

en-US Inglés (Estados Unidos)

En los casos en los que no deba especificar la región geográfica, puede dejar la parte de país del código de configuración local. Por ejemplo, el texto en inglés es el mismo para Inglés US e Inglés UK y se puede etiquetar con el código abreviado "en".

Códigos de marcaciónEspecifique códigos de marcación internacionales con códigos de países de la recomendación International Telecommunication Union (ITU) E.164.

Para obtener una lista de códigos, vaya a:

https://www.itu.int/itudoc/itu-t/ob-lists/icc/e164_763.html

Ejemplos

Código Significado

55 Brasil

81 Japón

1 Estados Unidos

Guía de soluciones cXMLSistemas de codificación recomendados

PUBLICPÚBLICO 427

Page 428: 355a de soluciones cXML - help.sap.com

Limitaciones de responsabilidad y aspectos legales

HiperenlacesAlgunos enlaces se clasifican con un icono y/o con un texto al pasar el puntero del ratón. Estos enlaces proporcionan información adicional.Acerca de los iconos:

● Enlaces con el icono Está entrando en una página Web que no está alojada por SAP. Al usar este tipo de enlaces, manifiesta su acuerdo (a no ser que se indique expresamente lo contrario en sus contratos con SAP) con lo siguiente:

● El contenido del sitio al que se accede a través del enlace no es documentación SAP. No puede realizar ninguna reclamación de producto contra SAP en base a esta información.

● SAP no manifiesta su acuerdo o desacuerdo con el contenido del sitio al que se accede a través del enlace, ni garantiza su disponibilidad o exactitud. SAP no es responsable de ningún daño causado por el uso de este contenido a menos que los daños se hayan causado por una imprudencia grave o por una conducta fraudulenta dolosa por parte de SAP.

● Enlaces con el icono Está dejando la documentación para este producto o servicio de SAP en concreto y está entrando en un sitio Web alojado por SAP. Al usar este tipo de enlaces, manifiesta su acuerdo (a no ser que se indique expresamente lo contrario en sus contratos con SAP) a no realizar ninguna reclamación de producto contra SAP en base a esta información.

Vídeos alojados en plataformas externasAlgunos vídeos pueden dirigir a plataformas de hospedaje de vídeos de terceros. SAP no puede garantizar la disponibilidad futura de vídeos almacenados en estas plataformas. Además, cualquier anuncio u otro contenido alojado en estas plataformas (p. ej., vídeos sugeridos o la navegación a otros vídeos alojados en el mismo sitio), no se encuentra bajo el control o la responsabilidad de SAP.

Beta y otras funciones experimentalesLas funciones experimentales no forman parte del alcance de la entrega oficial que SAP garantiza para futuras versiones. Esto significa que SAP puede modificar las funciones experimentales en cualquier momento, por cualquier motivo y sin previo aviso. Las funciones experimentales no están previstas para su uso productivo. No podrá mostrar, probar, examinar, evaluar las funciones experimentales o realizar cualquier otro uso de ellas en un entorno operativo en directo o con datos que no estén suficientemente fundamentados.El propósito de las funciones experimentales es obtener de manera anticipada comentarios que permitan a los clientes y partners influir en el producto futuro en consecuencia. Al proporcionar su opinión (p. ej. en la Comunidad SAP), acepta que los derechos de propiedad intelectual de las contribuciones o de las tareas derivadas seguirán siendo propiedad exclusiva de SAP.

Código de ejemploCualquier codificación de software y/o fragmentos de código son ejemplos. No están previstos para su uso productivo. El código de ejemplo tiene el único propósito de explicar y permitir la visualización de las reglas de sintaxis y de redacción SAP no garantiza la exactitud ni la integridad de los códigos de ejemplo. SAP no es responsable de ningún error o daño causado por el uso de código de ejemplo a menos que los daños se hayan causado por una imprudencia grave o por una conducta fraudulenta dolosa por parte de SAP.

Lenguaje sin sesgosSAP apoya una cultura de diversidad e inclusión. Siempre que sea posible, utilizamos un lenguaje imparcial en nuestra documentación para referirnos a personas de todas las culturas, etnias, géneros y habilidades.

428PUBLICPÚBLICO

Guía de soluciones cXMLLimitaciones de responsabilidad y aspectos legales

Page 429: 355a de soluciones cXML - help.sap.com

Guía de soluciones cXMLLimitaciones de responsabilidad y aspectos legales

PUBLICPÚBLICO 429

Page 430: 355a de soluciones cXML - help.sap.com

www.ariba.com

© 2022 SAP SE o una empresa filial de SAP. Reservados todos los derechos.

Queda prohibida la reproducción o transmisión de cualquier parte de esta publicación, en cualquier forma o para cualquier fin, sin el permiso expreso de SAP SE o de una empresa filial de SAP. La información que aquí se incluye puede modificarse sin previo aviso.

Algunos productos de software comercializados por SAP SE y sus distribuidores contienen componentes de software con derechos de autor de otros proveedores de software. Las especificaciones de productos en cada país pueden ser diferentes.

SAP SE o una empresa filial de SAP SE proporcionan estos materiales con fines meramente informativos, sin manifestación ni garantía de ningún tipo. Ni SAP SE ni sus empresas filiales se hacen responsables de los errores u omisiones en relación con los materiales. Las únicas garantías para los productos y servicios de SAP SE o de sus empresas filiales son aquellas especificadas en las cláusulas expresas de garantía que acompañan a dichos productos y servicios, si las hubiera. Nada de lo que se incluye en este documento debe interpretarse como garantía adicional.

SAP y los productos y servicios de SAP mencionados, así como sus respectivos logotipos, son marcas comerciales o marcas registradas de SAP SE (o de una empresa filial de SAP) en Alemania y en otros países. Todos los nombres y servicios de productos son las marcas comerciales de sus respectivas empresas.

Consulte https://www.sap.com/spain/about/legal/trademark.html para obtener información y avisos adicionales sobre marcas comerciales.

THE BEST RUN