Consulta a Padrn Constancia de Inscripcin ws sr ... Consulta a Padrn Constancia de Inscripcin...

download Consulta a Padrn Constancia de Inscripcin ws sr ...  Consulta a Padrn Constancia de Inscripcin ws_sr_constancia_inscripcion Manual para el desarrollador Versin 2.0 27/11/17

of 21

  • date post

    18-Apr-2018
  • Category

    Documents

  • view

    233
  • download

    7

Embed Size (px)

Transcript of Consulta a Padrn Constancia de Inscripcin ws sr ... Consulta a Padrn Constancia de Inscripcin...

  • AFIP

    Consulta a Padrn Constancia deInscripcin

    ws_sr_constancia_inscripcion

    Manual para el desarrollador

    Versin 2.027/11/17

  • AFIP- ws_sr_constancia_inscripcion Versin: 2.0

    Especificaciones tcnicas de Servicios Web Fecha: 27/11/17

    Historial de modificaciones

    Ver Fecha Edicin Descripcin1.0 13/01/17 DINTR Versin inicial del documento

    2.0 27/11/17 DINTR Cambio de nombre del WS de ws_sr_padron_a5 a ws_sr_constancia_inscripcion

    Pg. 1 de22

  • AFIP- ws_sr_constancia_inscripcion Versin: 2.0

    Especificaciones tcnicas de Servicios Web Fecha: 27/11/17

    Contenido

    IndiceINTRODUCCIN................................................................................................................................. 3ALCANCE............................................................................................................................................... 3DEFINICIONES........................................................................................................................................ 3

    WEB SERVICES.................................................................................................................................. 4SITIO DE CONSULTA Y CANAL DE ATENCIN..............................................................................................4AUTENTICACIN..................................................................................................................................... 4URLS:................................................................................................................................................... 4ID DEL SERVICIO.................................................................................................................................... 5

    MTODOS........................................................................................................................................... 5DUMMY (VERIFICACIN DEL SERVICIO).....................................................................................................5SOLICITUD............................................................................................................................................. 5RESPUESTA........................................................................................................................................... 5EJEMPLO............................................................................................................................................... 6MTODO GETPERSONA........................................................................................................................... 7SOLICITUD............................................................................................................................................. 7RESPUESTA........................................................................................................................................... 8EJEMPLO............................................................................................................................................... 9

    DEFINICIONES DE TIPOS DE DATOS.............................................................................................12TIPOS DE DATOS SIMPLES..................................................................................................................... 12TIPOS DE DATOS COMPLEJOS...............................................................................................................12

    ANEXOS............................................................................................................................................ 19VALORES TIPOREGIMEN:...................................................................................................................... 19VALORES TIPODATOADICIONAL:............................................................................................................20

    Pg. 2 de22

  • AFIP- ws_sr_constancia_inscripcion Versin: 2.0

    Especificaciones tcnicas de Servicios Web Fecha: 27/11/17

    1 Introduccin

    El servicio de Consulta de la Constancia de Inscripcin de Padrn, antes llamado de Alcance 5(ws_sr_padron_a5), permite que un organismo externo acceda a los datos de la constancia de uncontribuyente registrado en el Padrn de AFIP.

    La consulta se realiza mediante un webService SOAP que bsicamente recibe como parmetrouna CUIT y responde, con los datos que constituyen la constancia de inscripcin, del contribuyenteidentificado con la misma.

    Este documento est dirigido a quienes tengan la misin de probar y utilizar este webService.

    Para tener acceso a este webService el organismo usuario debe obtener un ticket de acceso.

    El proceso de obtencin del ticket de acceso esta fuera del alcance de este documento.

    1.1 Alcance

    Este WS se puede utilizar para acceder a datos de un contribuyente relacionados con suconstancia de inscripcin.

    1.2 Definiciones, Siglas y Abreviaturas

    SOAP Simple Object Access ProtocolWSDL Web Services Definition Language

    WSAA Web Service de Autenticacin y Autorizacin de AFIP

    WSPCI Web Service de Padrn Constancia de Inscripcin

    CE Cliente externo usuario de los webServices de AFIP

    CUIT Clave Unica de Identificacin Tributaria.Campo numrico de 11 dgitos que identificada unvocamente aun contribuyente.

    SSO Ticket para poder acceder a los webServices de AFIP. Son generados por WSAA.

    SUPA Sistema nico de parmetros

    Pg. 3 de22

  • AFIP- ws_sr_constancia_inscripcion Versin: 2.0

    Especificaciones tcnicas de Servicios Web Fecha: 27/11/17

    2. Web Services

    2.1. Sitio de consulta y canal de atencinPara consultas acerca de la arquitectura de Web Services, autenticacin yautorizacin dirigirse a http://www.afip.gob.ar/ws/.Las consultas sobre aspectos tcnicos del WS debern ser remitidas a la cuenta sri@afi-

    p.gob.ar. Para su mejor tratamiento, se solicita detallar en el asunto la denominacin del WS y ambiente de que se trate (Produccin y Homologacin), como as tambin adjuntar requesty response.

    Para consultar propias del negocio o normativas, contactarse mediante el sitio www.afi-p.gob.ar/consultas.

    2.2. AutenticacinPara la utilizacin de los mtodos el webService, a excepcin del dummy, se debe enviar en cada solicitud, el token y el sign, informacin que es obtenida del WSAA (Web Service de Autenticacin y Autorizacin), en respuesta a una solicitud de ti-cket de acceso.

    2.3. URLs:

    Descripcin URL

    Conexin al servicio en am-biente de Testing

    https://awshomo.afip.gov.ar/sr-padron/webservices/personaServiceA5

    WSDLdel servicio en am-biente de Testing

    https://awshomo.afip.gov.ar/sr-padron/webservices/personaServiceA5?WSDL

    Conexin al servicio en am-biente de Produccin

    https://aws.afip.gov.ar/sr-padron/webservices/personaServiceA5

    WSDL del servicio en am-biente de Produccin

    https://aws.afip.gov.ar/sr-padron/webservices/personaServiceA5?WSDL

    Pg. 4 de22

    https://awshomo.afip.gov.ar/sr-padron/webservices/personaServiceA5?WSDLhttps://awshomo.afip.gov.ar/sr-padron/webservices/personaServiceA5?WSDLhttps://aws.afip.gov.ar/sr-padron/webservices/personaServiceA5?WSDLhttps://aws.afip.gov.ar/sr-padron/webservices/personaServiceA5?WSDLhttps://aws.afip.gov.ar/sr-padron/webservices/personaServiceA5https://aws.afip.gov.ar/sr-padron/webservices/personaServiceA5https://awshomo.afip.gov.ar/sr-padron/webservices/personaServiceA5?WSDLhttps://awshomo.afip.gov.ar/sr-padron/webservices/personaServiceA5?WSDL

  • AFIP- ws_sr_constancia_inscripcion Versin: 2.0

    Especificaciones tcnicas de Servicios Web Fecha: 27/11/17

    2.4. ID del Servicio

    El id del servicio es ws_sr_constancia_inscripcion. El mismo es el nombre deservicio que se deber usar al solicitar a WSAA el Ticket de Acceso.

    3. Mtodos

    3.1.dummy (Verificacin del servicio)

    Nombre mtodo: dummy

    Descripcin: El mtodo dummy verifica el estado y la disponibilidad de loselementos principales del servicio (aplicacin, autenticacin y base de datos).

    3.1.1. Solicitud:

    3.1.2. Respuesta:

    ?

    ?

    ?

    Pg. 5 de22

  • AFIP- ws_sr_constancia_inscripcion Versin: 2.0

    Especificaciones tcnicas de Servicios Web Fecha: 27/11/17

    Donde dummyResponse es del tipo dummyResponse definido en el WSDL y contienela etiqueta return del tipo dummyReturn.

    Los valores de los atributos appserver, authserver y dbserver pueden ser OK o, encaso de falla, ERROR.

    3.1.3. Ejemplo: Invocacin del mtddo:

    Respuesta del mtodo:

    OK

    OK

    OK

    Pg. 6 de22

  • AFIP- ws_sr_constancia_inscripcion Versin: 2.0

    Especificaciones tcnicas de Servicios Web Fecha: 27/11/17

    3.2. Mtodo getPersona

    Nombre mtodo: getPersona

    Descripcin: Devuelve el detalle de todos los datos, correspondientes a laconstancia de inscripcin, del contribuyente solicitado.

    3.2.1. SolicitudEsquema:

    ?

    ?

    ?

    ?

    Donde a5:getPersona es del tipo getPersona y engloba los parmetros de

    entrada:

    token y sign: Los mismos son devueltos por el web service de autenticacinWSAA.

    cuitRepresentada: Debe coincidir con alguna de las CUITS listadas en la seccinrelations del token enviado. Debe ser en representacin de que organismo sesolicita la operacin.

    idPersona: Es la clave de la que se solicitan los datos.

    Pg. 7 de22

  • AFIP- ws_sr_constancia_inscripcion Versin: 2.0

    Especificaciones tcnicas de S