Servicios web de distribución digital (DDWS) GetPartnerDesignation - Manual de servicio

Documentos relacionados
ESPECIFICACIONES DE SERVICIOS ABIERTOS

PROTOTIPO DE FACTURACIÓN ELECTRÓNICA MANUAL TÉCNICO

Manual de Usuario para Proponentes

BANCO CENTRAL DE VENEZUELA

SICRES 3.0 Presentación Ejecutiva

Sistema de envíos UPS Access Point Preguntas más frecuentes

Instructivo 3: Ingreso de datos para completar la solicitud de inscripción.

T A B L A D E C O N T E N I D O

ESET Secure Authentication

DIRECCIÓN GENERAL DE REGISTRO CIVIL, IDENTIFICACIÓN Y CEDULACIÓN. Sistema Nacional de Identificación Ciudadana. Manual de Usuario

1. Usted deberá ingresar al portal para generar su registro y obtener su factura.

MANUAL INTEGRACIÓN PUNTO WEB PARÁMETROS DE COMUNICACIÓN

MANUAL CARGA DE FACTURACION ELECTRONICA EN PORTAL TEKSID

Facturación electrónica de Primas

Sistema de Presentación y Gestión de Proyectos Instructivo para la carga de Proyectos.

SERVICIO DE ENVÍO MASIVO DE MENSAJES MMS MULTIMEDIA HTTPS/API

Especificaciones técnicas y funcionales para la integración con la. Bolsa de Valores de Colombia. BUS de Integración BVC Mejoras notificación SAE

Manual de Instrucción para el usuario del sistema de TELE-MAPA

INSTRUCTIVO BASICO DE RADICADO INTERNO PARA EL MANEJO DEL SISTEMA DE GESTIÓN DOCUMENTAL MERCURIO WEB VERSIÓN 6.0

Requiriendo Certificados de WiseKey.com

BANCO CENTRAL DEL ECUADOR ENTIDAD DE CERTIFICACIÓN DE INFORMACIÓN

Guía de inicio rápido de CitiManager Titulares de tarjetas

Sistema de Comunicación Transporte - Distribución

Informar a los usuarios de la aplicación FDAA de cómo usarla

Manual de Identidad Visual

Secur Guía del usuario

DETALLE DE LA FUNCIONALIDAD DEL SISTEMA. Ingreso al sistema PREINSCRIPCIÓN DEL RUC POR INTERNET

ESTRUCTURA DE NAVEGACIÓN MÓDULO ALMACENES - REPORTES TABLA DE CONTENIDO

Guía de Solicitud de apoyo

CONFIGURACIÓN DE FIRMA DIGITAL EN WORD 2013

Agente de Comunicaciones Manual de Usuario

Documentos Tributarios Electrónicos

SERVICIOS WEB DE INTEGRACIÓN PARA PROVEEDRORES

Invertir Innovar Transformarse INSTRUCTIVO DE REGULACION DE CUENTAS Y AUXILIARES. Pensar en grande, empezar en pequeño, crecer rápido

Anulación de comprobantes electrónicos

Guía de usuario PayPhone Store

DIRECCIÓN GENERAL DE REGISTRO CIVIL, IDENTIFICACIÓN Y CEDULACIÓN. Sistema Nacional de Identificación Ciudadana. Manual de Usuario

Guía para generar el link de pago en el modulo administrativo de PagosOnLine VERSION 2.0

Libro de Clases Electrónico (LCE) Liquidación de cursos Franquicia Tributaria:

GUIA DE USO DEL LOGO CERTFOR

Manual de Usuario. Manual de Usuario. Aplicación de Reinicio de Contraseña para Office 365 VERSION: 1.0. Realizado: 28 de Enero de 2016 Página 1 de 11

MANUAL DE USUARIO MEDIOS DE PAGO - SISEC. Para: CRC. (Centro de Reconocimiento de Conductores) Versión de la plantilla

UNIDAD DE NORMAS Y PROCEDIMIENTOS

Uso de la función Imprimir y mantener en espera

Si usted quiere desarrollar con Bluevia y Java, esto es lo primero que debe saber

Convocatoria C Convocatoria 2016

Manual de usuario Portal de Proveedores

Facturación Electrónica

Mi Buzón Electrónico Cuenta Receptora

Protección al Vendedor en México

Preguntas Frecuentes de Factura Electrónica (CFD) Reporte Mensual

SERVICIO B2BCONECTA DE FACTURACIÓN INTEGRAL DEL GRUPO RENFE MANUAL DE USUARIO CLIENTE RECEPTOR DE FACTURA ELECTRÓNICA

Este Manual tiene como propósito ser la referencia parar dar respuesta a los principales cuestionamientos sobre el Módulo Fiscal.

TELECO CHILE S.A. WSDL SOAP de Acceso a Plataforma SMS

ANEXO APLICACIÓN DE FIRMA

Solicitud de Certificación Histórica de Calificaciones por Grado Académico Contenido

Figura 41: Ejemplo de una carta para combinar correspondencia

Manual de Usuario. Solicitud de Reintegro de Gastos por Servicios de Salud

A continuación, se presenta un resumen de las plataformas y la manera de accederlas.

Manual de Usuario Cambio de unidad certificadora Banco Central de Costa Rica Manual de Operación

Aplicateca API Certificados SMS -

PARAMETRIZACION CONTABLE DEL MÓDULO VENTAS

Creación y Habilitación de Nuevos Usuarios para envío de la información

Políticas Internas de los Cursos Mooc para Estudiantes

Matriz de Riesgos y Controles. Proceso Contable.

Aula Virtual DAE. Manual de uso sobre el funcionamiento del Aula Virtual - ALUMNOS -

Enterprise Architect:

Los campos con fondo azul deben cumplimentarse obligatoriamente, no pueden dejarse vacíos. Seleccionar Español en el menú desplegable

MANUAL PARA GESTIÓN DE METADATOS

Manual de usuario Tramitación Electrónica Tribunal Constitucional de Chile

PROFORMA INTERNA MANUAL DE USUARIO

GI-A.10.1-SA-07 GUIA RÁPIDA COMPRAR EN LÍNEA. Código: GI-A.10.1-SA-07 GUÍA RÁPIDA COMPRAR EN LÍNEA. Revisión:1 MANUAL

GUÍA DE USUARIO SOLICITUD DE CERTIFICACIÓN HISTÓRICA DE CALIFICACIONES

Indicadores de TIC en las empresas

Práctica #1 Crear Base de Datos

Ejemplo de Casos de Uso. Gestión básica de una biblioteca.

Guía de instalación para tabletas. McAfee All Access

MECANISMOS FUERTES DE AUTENTICACIÓN CIRCULAR 042 DE 2012 SUPERINTENDENCIA FINANCIERA

Firma digital de actas académicas

ACCIONES CORRECTIVAS Procedimiento

API VERSIÓN 4.0 DOCUMENTACIÓN PARA INTEGRACION DE SITIOS WEB

NOTIFICACIÓN DE EXPORTACIÓN (NE)

5.3 CREAR FORMULARIOS

MANUAL DE PROCEDIMIENTOS DEL CENTRO DE CÓMPUTO PROCEDIMIENTO PARA ALTA, BAJA Y CAMBIO DE USUARIO DE SIAC OBJETIVO

Infor LN - Guía del usuario para catálogos de productos

Invertir Innovar Transformarse INSTRUCTIVO DE REPORTES DINÁMICOS DE EJECUCIÓN PRESUPUESTARIA. Pensar en grande, empezar en pequeño, crecer rápido

GUÍA DEL USUARIO - ADMINISTRADOR TPV VIRTUAL

FactureYa. Guía Rápida para Formularios de Compra 2011 v3.0.1

POS MULTIMERCHANT MANUAL DEL COMERCIO

FORMATO INFORMACIÓN ELECTRÓNICA DE COMPRAS Y VENTAS PARA ENTREGA DETALLADA SEGÚN RESOLUCIÓN 42 DEL

PROCEDIMIENTO USO-002-OL GESTION DE ACTUALIZACION DE CONTRASEÑA SPRCONLINE Julio 2013 Versión 2.0

Deberás ingresar a través del sitio del Banco a la solapa Empresas y de ahí al banner titulado Banca Electrónica Empresas

Icing On The Cake (IOC)

GUIA RÁPIDA PARA LA PRESENTACIÓN DE TESIS Y TRABAJOS DE GRADO EN FORMATO DIGITAL PRESENTACIÓN

BOLETÍN INFORMATIVO. Publicación del Flotante de los emisores

Norma de seguridad de datos de la Industria de tarjetas de pago (PCI)

Manual de instalación Certitool.

Funcionalidad Ten ERP Factura-e v2.46

FUNDAMENTOS DE INFORMÁTICA

Con Aspel-SAE 5.0 Cómo migrar de Comprobantes con Código de barras bidimensional CBB a Comprobantes Fiscales Digitales por Internet CFDI?

Transcripción:

Servicios web de distribución digital (DDWS) GetPartnerDesignation - Manual de servicio

CONTENIDO Historial de revisiones... 2 1 Introducción... 3 1.1 Descripción general... 3 1.2 Documentación complementaria... 3 2 Para empezar... 3 3 Descripción general del servicio de designación de distribuidores... 4 3.1 Ventajas del servicio GetPartnerDesignation... 4 4 Información de referencia del servicio GetPartnerDesignation... 5 4.1 Esquema de solicitud... 5 4.2 Esquema de respuesta... 5 4.3 Esquema de error... 6 4.4 Mensajes de solicitud... 7 4.5 Mensaje de respuesta... 7 4.5.1 Mensaje de respuesta: GetPartnerDesignation con el CSN del distribuidor como entrada... 7 4.5.2 Mensaje de respuesta: GetPartnerDesignation con el código de país como entrada... 9 4.6 Mensajes de error... 11 4.6.1 Ejemplo de respuesta de error... 12 Historial de revisiones Versión Fecha Autor Comentarios 1.1 02/09/2016 SJ Versión inicial 2 Manual de referencia del servicio web

1 Introducción 1.1 Descripción general La plataforma de servicios web de distribución digital (DDWS) es una solución de automatización que permite a nuestros socios realizar pedidos directamente a Autodesk; este proceso requiere muy pocos pasos por parte de los socios y ninguno por parte de Autodesk. Esta nueva función de negocio permitirá realizar verdaderas transacciones de servicio web B2B entre los socios y Autodesk. Para que los socios disfruten de una implementación eficaz de la plataforma de servicios digitales de Autodesk, las filiales deberán familiarizarse con los servicios web de REST, OAuth y JSON. En un documento llamado Guía a la programación, se ofrece un ejemplo de aplicación cliente (escrita en lenguaje Ruby) que ayudará a los desarrolladores de las filiales a usar la API del servicio digital. 1.2 Documentación complementaria Guía para desarrolladores de socios de Autodesk: esta guía ayudará a los socios en su proceso de incorporación y acceso a los servicios de DDWS. La guía sirve también para presentar a los socios la plataforma de servicios digitales de Autodesk, con instrucciones paso a paso que les guiarán a través de las actividades iniciales necesarias para la integración. Documentación de la API de autenticación: este documento guía a los socios a través del proceso de generación de credenciales, firmas y tokens de acceso necesarios para utilizar las API del servicio. También contiene información para el desarrollo de la aplicación de integración de un socio. Proporciona información básica acerca de la integración del servicio web y muestra el desarrollo de una aplicación típica. 2 Para empezar Como parte del proceso de incorporación, los socios deberán estar asociados con un único número específico del cliente (CSN, del inglés Customer Specific Number) y su aplicación deberá estar registrada con Autodesk. Para obtener más información sobre el proceso de incorporación, consulte la Guía para desarrolladores de socios de Autodesk. 3 Manual de referencia del servicio web

3 Descripción general del servicio de designación de distribuidores Este servicio hace y proporciona lo siguiente: Obtiene la información de cuenta, la cuenta de contrato y la información sobre la experiencia en función del CSN del distribuidor o el país especificados. Valida los CSN y los CSN de distribuidor proporcionados. Si la solicitud no es válida, la respuesta devuelve un error. 3.1 Ventajas del servicio GetPartnerDesignation 1. Se trata de un informe de autoservicio basado en datos en tiempo real. a. Cuando se modifica un contrato, esto se refleja inmediatamente en este informe. b. Reemplaza los informes semanales publicados actualmente en Partner Center (VAR Spez Report Dist) 2. Un servicio web de REST ligero que se puede consumir fácilmente desde cualquier aplicación. 3. La flexibilidad de los distribuidores para obtener la información de la experiencia con un número CSN de distribuidor específico o proporcionando un código de país. 4 Manual de referencia del servicio web

4 Información de referencia del servicio GetPartnerDesignation 4.1 Esquema de solicitud Los detalles de los parámetros del mensaje de solicitud se encuentran en la tabla siguiente para GetPartnerDesignation. Elemento Tipo de campo Longitud/formato de entrada Utilización CSN Cadena 10 Obligatorio CountryCode Cadena Código de país ISO de 2 dígitos Obligatorio si no se proporciona el ResellerCSN. ResellerCSN Cadena 10 Obligatorio si no se proporciona el CountryCode. 4.2 Esquema de respuesta Para el envío del intervalo de fechas, se muestran las siguientes columnas. Campo PartnerDesignationList Tipo de campo Matriz de objeto JSON Longitud y formato de salida Descripción AccountCSN Cadena 30 Un identificador exclusivo de una cuenta de empresa/distribuidor/cliente final ParentAccountCSN Cadena 30 CSN de la cuenta principal en la jerarquía (por ejemplo, Doméstico Primordial) AccountName Cadena 255 Nombre de la empresa asociada a la cuenta Address1 Cadena 255 Dirección física de la empresa asociada a la cuenta Address2 Cadena 100 Dirección física de la empresa asociada a la cuenta Address3 Cadena 100 Dirección física de la empresa asociada a la cuenta City Cadena 50 Ciudad del distribuidor ZipCode Cadena 30 Código postal del distribuidor State Cadena 50 Estado del distribuidor Country Cadena 50 País del distribuidor SalesRegion Cadena 40 Región de ventas en el contrato del distribuidor 5 Manual de referencia del servicio web

ContractEndDate Formato de fecha ISO 8601 10 Fecha de finalización del contrato del distribuidor ContractType Cadena 255 Tipo de contrato basado en el tipo de distribuidor PartnerHierachy Cadena 255 Cuenta en la jerarquía PartnerTier Cadena 255 Nivel del distribuidor en el contrato del distribuidor ExpertiseList Matriz de objetos JSON ExpertiseType Cadena 255 Tipo de especialización al que está asociado el distribuidor. Expertise Cadena 80 Especialización a la que está asociado el distribuidor. Matriz de objetos JSON error_code Cadena 13 Código de error error_message Cadena 250 Mensaje de error 4.3 Esquema de error Nombre de campo PartnerDesignationList Mensaje de error Código de error Descripción null Un breve resumen que indica el error. Un código con el formato 000XX. 6 Manual de referencia del servicio web

4.4 Mensajes de solicitud A continuación se muestran solicitudes de ejemplo de GetPartnerDesignation. [Getting GetPartnerDesignation using Reseller CSN] https://enterprise-api-stg.autodesk.com/v1/partnerdesignation?resellercsn=1234567890 Message Headers Content-Type: application/json Authorization: Bearer <<Access Token>> CSN: <<CSN>> signature: <<Signed Access Token>> timestamp: <<Timestamp for the signed Access Token>> [Getting GetPartnerDesignation using Country Code] https://enterprise-api-stg.autodesk.com/v1/partnerdesignation?countrycode=me Message Headers Content-Type: application/json Authorization: Bearer <<Access Token>> CSN: <<CSN>> signature: <<Signed Access Token>> timestamp: <<Timestamp for the signed Access Token>> 4.5 Mensaje de respuesta Nota: Autodesk enviará una respuesta con la siguiente estructura. Los socios pueden cambiar el formato en distintas estructuras en función de sus necesidades. 4.5.1 Mensaje de respuesta: GetPartnerDesignation con el CSN del distribuidor como entrada "PartnerDesignationList": [ "ZipCode": "560086", "State": "KARNATAKA", "SalesRegion": "INDIA", "PartnerTier": "Gold", 7 Manual de referencia del servicio web

"PartnerHierachy": "Domestic Ultimate", "ParentAccountCSN": "5070293421", "ExpertiseList": [ "Expertise": "AutoCAD" "Expertise": "M&E" "ExpertiseType": "Product Group", "Expertise": "Base" "Expertise": "Building" "Expertise": "Civil Infrastructure" "Expertise": "Product Design & Manufacturing" "ExpertiseType": "Product Group", "Expertise": "Open" "Expertise": "Advanced Structure" ], "Country": "India", "ContractType": "IVAR", "ContractEndDate": "2016-01-31", "City": "Bengaluru", "Address3": null, "Address2": "EBIPBCHKGB", "Address1": "AFAEAFHGDM", "AccountName": "NHFGGLIOAMKJNNEIELFIGCIBDPOLIEON", "AccountCSN": "5070293421" ], "error_message": "", "error_code": "" 8 Manual de referencia del servicio web

4.5.2 Mensaje de respuesta: GetPartnerDesignation con el código de país como entrada "PartnerDesignationList": [ "ZipCode": "81000", "State": null, "SalesRegion": "Central Europe", "PartnerTier": "Silver", "PartnerHierachy": "Domestic Ultimate", "ParentAccountCSN": "5101529925", "ExpertiseList": [ "ExpertiseType": "Product Group", "Expertise": "Base" "Expertise": "Civil Infrastructure" "ExpertiseType": "Product Group", "Expertise": "Open" "Expertise": "AutoCAD" ], "Country": "Montenegro", "ContractType": "IVAR", "ContractEndDate": "2016-01-31", "City": "Podgorica", "Address3": null, "Address2": "HKIJFOMGJE", "Address1": "JHOIDNIPME", "AccountName": "KGGLHLGJLOEEDDJCDGMHMGGLPIOMEBGN", "AccountCSN": "5101529925" "ZipCode": "81000", "State": null, "SalesRegion": "Central Europe", "PartnerTier": "Bronze", "PartnerHierachy": "Domestic Ultimate", "ParentAccountCSN": "5104195857", "ExpertiseList": [ "Expertise": "AutoCAD" ], 9 Manual de referencia del servicio web

"Country": "Montenegro", "ContractType": "IVAR", "ContractEndDate": "2016-01-31", "City": "Podgorica", "Address3": null, "Address2": null, "Address1": "NECDGMEGDE", "AccountName": "OBJAMNAMMKBAJHJKDHJPGCMMDAKAGPKJ", "AccountCSN": "5104195857" "ZipCode": "81000", "State": null, "SalesRegion": "Central Europe", "PartnerTier": "Bronze", "PartnerHierachy": "Domestic Ultimate", "ParentAccountCSN": "5106831422", "ExpertiseList": [ "ExpertiseType": "Product Group", "Expertise": "Base" "ExpertiseType": "Product Group", "Expertise": "Open" "Expertise": "AutoCAD" ], "Country": "Montenegro", "ContractType": "IVAR", "ContractEndDate": "2016-01-31", "City": "Podgorica", "Address3": null, "Address2": null, "Address1": "HCLKLBBPIB", "AccountName": "MGFHEAHPMLHLPBHHONCODBPDEEILAOAF", "AccountCSN": "5106831422" ], "error_message": "", "error_code": "" 10 Manual de referencia del servicio web

4.6 Mensajes de error La siguiente tabla muestra los códigos de error y sus respectivos mensajes de error presentes en los mensajes de respuesta si se detecta un error: Número de mensaje 00005 00001 00002 00003 00004 04103 04102 04100 04104 04303 04300 04302 04301 Mensaje de error CSN no autorizado El CSN del distribuidor proporcionado no es válido o no tiene un tipo de distribuidor válido. El código de país no es válido. No se han encontrado contratos activos del CSN. Proporcione el ResellerCSN o el CountryCode. Falta el sello horario en el encabezado. Falta la firma en el encabezado. Falta el CSN en el encabezado. Falta la autorización en el encabezado. Token no válido en el encabezado. CSN no válido en el encabezado. Sello horario no válido en el encabezado. Firma no válida en el encabezado. Descripción del error Este error se generará si el CSN del comprador enviado por el distribuidor no es de tipo de Distribuidor principal o Distribuidor. Este error se generará si el CSN de distribuidor proporcionado no tiene un tipo de distribuidor, distribuidor principal, VCP o ISV. Este error se generará si el código de país proporcionado no es válido. Este error se generará si no se ha encontrado ningún contrato activo del CSN del distribuidor. Este error se generará si no se proporciona ninguna de las entradas de ResellerCSN o CountryCode. Este error se generará si no se ha definido el sello horario del encabezado en la solicitud. Este error se generará si no se ha definido la firma del encabezado en la solicitud. Este error se generará si no se ha definido el CSN del encabezado en la solicitud. Este error se generará si no se ha definido la autorización del encabezado en la solicitud. Este error se generará si el valor de la autorización del encabezado es incorrecto o no válido. Este error se generará si el valor del CSN del encabezado es incorrecto o no válido. Este error se generará si el valor del sello horario del encabezado es incorrecto o no válido. Este error se generará si el valor de la firma del encabezado es incorrecto o no válido. 11 Manual de referencia del servicio web

4.6.1 Ejemplo de respuesta de error "PartnerDesignationList": null, "error_message": "Please provide ResellerCSN or CountryCode." "error_code": "00004" Nota: Este Manual de referencia del servicio es para uso exclusivo de los destinatarios a los que se dirige y puede contener información propietaria o confidencial que pueda ser información reservada o estar protegida frente a la divulgación. Queda totalmente prohibida cualquier revisión, uso, difusión o distribución no autorizados. 12 Manual de referencia del servicio web