AFIP Manual Ws Sr Padron A4 V1.1

User Manual:

Open the PDF directly: View PDF .
Page Count: 29

Download
Open PDF In Browser	View PDF

AFIP

Consulta a Padrón Alcance 4
ws_sr_padron_a4
Manual para el desarrollador

Versión 1.1
12/12/16

AFIP- ws_sr_padron_a4

Versión:

1.1

Fecha:

Especificaciones técnicas de Servicios Web

12/12/16

Historial de modificaciones
Ver

Fecha

Edición

1.0

06/12/16

DINTR

Versión inicial del documento

Descripción

1.1

12/12/16

DINTR

Versión corregida de acuerdo a revisión de WS

Pág. 1 de
30

AFIP- ws_sr_padron_a4

Versión:

Especificaciones técnicas de Servicios Web

Fecha:

1.1
12/12/16

Contenido

Indice
INTRODUCCIÓN................................................................................................................................. 3
ALCANCE............................................................................................................................................... 3
DEFINICIONES........................................................................................................................................ 3
WEB SERVICES.................................................................................................................................. 4
SITIO DE CONSULTA Y CANAL DE ATENCIÓN..............................................................................................4
AUTENTICACIÓN..................................................................................................................................... 4
URLS:................................................................................................................................................... 4
ID DEL SERVICIO.................................................................................................................................... 6
MÉTODOS........................................................................................................................................... 6
DUMMY (VERIFICACIÓN DEL SERVICIO)..................................................................................................... 6
SOLICITUD............................................................................................................................................. 6
RESPUESTA........................................................................................................................................... 6
EJEMPLO............................................................................................................................................... 7
MÉTODO GETPERSONA........................................................................................................................... 8
SOLICITUD............................................................................................................................................. 8
RESPUESTA........................................................................................................................................... 9
EJEMPLO............................................................................................................................................. 10
DEFINICIONES DE TIPOS DE DATOS............................................................................................. 15
TIPOS DE DATOS SIMPLES..................................................................................................................... 15
TIPOS DE DATOS COMPLEJOS............................................................................................................... 16
ANEXOS............................................................................................................................................ 23
VALORES TIPORESIDENCIA:.................................................................................................................. 24
VALORES TIPOESTADO:........................................................................................................................ 24
VALORES TIPOREGIMEN:...................................................................................................................... 25
VALORES TIPOTELEFONO:.................................................................................................................... 25
VALORES TIPORELACION:..................................................................................................................... 26
VALORES SUBTIPORELACIÓN:............................................................................................................... 27
VALORES TIPOEMAIL:.......................................................................................................................... 30
VALORES TIPODATOADICIONAL:............................................................................................................ 30

Pág. 2 de
30

AFIP- ws_sr_padron_a4

Versión:

Especificaciones técnicas de Servicios Web

1.1

Fecha:

12/12/16

1 Introducción
El servicio de Consulta de Padrón Alcance 4 permite que un organismo externo acceda a los
datos de un contribuyente registrado en el Padrón de AFIP.
La consulta se realiza mediante un webService SOAP que básicamente recibe como
parámetro una CUIT y responde con los datos públicos del contribuyente identificado con la misma.
Este documento está dirigido a quienes tengan la misión de probar y utilizar este
webService.
Para tener acceso a este webService el organismo usuario debe obtener un ticket de
acceso.
El proceso de obtención 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 su
situación tributaria. Ejemplo: impuestos y regimenes en los que esta inscripto.

1.2 Definiciones, Siglas y Abreviaturas

SOAP
WSDL

Simple Object Acces Protocolo

WSAA

Web Service de Autenticación y Autorización de AFIP

WSPN3

Web Service de Padrón Nivel3

CE
CUIT

Web Services Definition Language

Cliente externo usuario de los webServices de AFIP
Clave Unica de Identificación Tributaria.
Campo numérico de 11 dígitos que identificada unívocamente a
un contribuyente.

SSO

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

SUPA

Sistema único de parámetros

Pág. 3 de
30

AFIP- ws_sr_padron_a4

Versión:

Especificaciones técnicas de Servicios Web

1.1

Fecha:

12/12/16

2. Web Services
2.1. Sitio de consulta y canal de atención
Para consultas acerca de la arquitectura de Web Services, autenticación y
autorización dirigirse a http://www.afip.gob.ar/ws/.
Las consultas sobre aspectos técnicos del WS deberán ser remitidas a la cuenta
sri@afip.gob.ar. Para su mejor tratamiento, se solicita detallar en el asunto la denominación
del WS y ambiente de que se trate (Producción y Homologación), como así también adjuntar
request y response.
Para consultar propias del negocio o normativas, contactarse mediante el sitio
www.afip.gob.ar/consultas.
2.2. Autenticación
Para la utilización de los métodos el webService, a excepción del dummy, se debe
enviar en cada solicitud, el token y el sign, información que es obtenida del WSAA
(Web Service de Autenticación y Autorización), en respuesta a una solicitud de ticket de acceso.
2.3. URLs:

Descripción

URL

Conexión al servicio en ambiente

https://awshomo.afip.gov.ar/srpadron/webservices/personaServiceA4

de Testing
WSDLdel servicio en ambiente

https://awshomo.afip.gov.ar/srpadron/webservices/personaServiceA4?WSDL

de Testing
Conexión al servicio en ambiente

https://aws.afip.gov.ar/srpadron/webservices/personaServiceA4

de Producción
WSDL del servicio en ambiente

https://aws.afip.gov.ar/srpadron/webservices/personaServiceA4?WSDL

de Producción
Pág. 4 de
30

AFIP- ws_sr_padron_a4
Especificaciones técnicas de Servicios Web

Versión:
Fecha:

1.1
12/12/16

2.4. ID del Servicio
El id del servicio es ws_sr_padron_a4. El mismo es el nombre de servicio que se
deberá usar al solicitar a WSAA el Ticket de Acceso.

3. Métodos

3.1. dummy (Verificación del servicio)
Nombre método: dummy
Descripción: El método dummy verifica el estado y la disponibilidad de los
elementos principales del servicio (aplicación, autenticación y base de datos).
3.1.1. Solicitud:






3.1.2. Respuesta:




?
?
?
Donde dummyResponse es del tipo dummyResponse definido en el WSDL y
contiene la etiqueta return del tipo dummyReturn.
Los valores de los atributos appserver, authserver y dbserver pueden ser OK o,
en caso de falla, ERROR.
Pág. 5 de
30

AFIP- ws_sr_padron_a4
Especificaciones técnicas de Servicios Web

Versión:
Fecha:

1.1
12/12/16

3.1.3. Ejemplo:
Invocación del métddo:






Respuesta del método:




OK
OK
OK





Pág. 6 de
30

AFIP- ws_sr_padron_a4
Especificaciones técnicas de Servicios Web

Versión:
Fecha:

1.1
12/12/16

3.2. Método getPersona
Nombre método: getPersona

Descripción: Devuelve el detalle de todos los datos, existentes en el padrón
único de contribuyentes, del contribuyente solicitado.
3.2.1. Solicitud
Esquema:




?
?
?
?




Donde a4:getPersona es del tipo getPersona y engloba los parámetros de
entrada:
token y sign: Los mismos son devueltos por el web service de autenticación
WSAA.
cuitRepresentada: Debe coincidir con alguna de las CUITS listadas en la sección
relations del token enviado. Debe ser en representación de que organismo se
solicita la operación.
idPersona: Es la clave de la que se solicitan los datos.

Pág. 7 de
30

AFIP- ws_sr_padron_a4
Especificaciones técnicas de Servicios Web

Versión:
Fecha:

1.1
12/12/16

3.2.2. Respuesta
Esquema:





?
?


…..





Donde getPersonaResponse, personaReturn, metadata y persona son del tipo del
mismo nombre, definidos en el WSDL del servicio.

Pág. 8 de
30

AFIP- ws_sr_padron_a4

Versión:

Especificaciones técnicas de Servicios Web

Fecha:

1.1
12/12/16

3.2.3. Ejemplo
Invocación del método:




ICAgIDwvcmVsYXRpb25zPgogICAgICAgIDwvbG9naW4+CiAgICA8L29wZX
JhdGlvbj4KPC9zc28+Cgo=
+7rFJNrEcIKRQ+A2xx0m9B9hlVXzU/XHvZEEY7XsvRMIDPRiSlsLR8+MBYH
TcfsO4=
20135464605
20000000516




Respuesta del ejemplo:





2016-12-02T11:12:37.087-03:00
setiwebhomoext.afip.gob.ar



CONSTRUCCIÓN, REFORMA Y REPARACIÓN DE
EDIFICIOS RESIDENCIALES
410011
883
1
201311
Pág. 9 de
30

AFIP- ws_sr_padron_a4

Versión:

Especificaciones técnicas de Servicios Web

Fecha:

1.1
12/12/16


ERNESTO DANIEL

DISTRITO ZAPALA
702


8371
N/A PATRICIA ANDREA
NEUQUEN
LAGUNA LOS SAUCES 2
20
JUNIN DE LOS ANDES
NO DETERMINADO
FISCAL


1425
CIUDAD AUTONOMA BUENOS AIRES
ARAOZ 1901
0
LEGAL/REAL

ACTIVO
2010-10-30T12:00:00-03:00
1891-01-01T12:00:00-03:00
20000000516

GANANCIAS PERSONAS FISICAS
30
BAJA DEFINITIVA
2002-04-05T12:00:00-03:00
11
200611

Pág. 10 de
30

AFIP- ws_sr_padron_a4

Versión:

Especificaciones técnicas de Servicios Web

Fecha:

1.1
12/12/16


MONOTRIBUTO
30
BAJA DEFINITIVA
2000-03-11T12:00:00-03:00
20
200406


MONOTRIBUTO AUTONOMO
30
BAJA DEFINITIVA
2000-03-11T12:00:00-03:00
21
200406


GANANCIA MINIMA PRESUNTA
30
BAJA DEFINITIVA
2005-03-15T12:00:00-03:00
25
200611


SICOREIMPTO.EMERG.AUTOMOTORES
31
BAJA DEFINITIVA
2008-01-29T12:00:00-02:00
64
200708


EMPLEADOR-APORTES SEG.
SOCIAL
Pág. 11 de
30

AFIP- ws_sr_padron_a4

Versión:

1.1

Fecha:

Especificaciones técnicas de Servicios Web

12/12/16

15
ACTIVO
2005-03-15T12:00:00-03:00
301
200503


APORTES

SEG.SOCIAL

AUTONOMOS
10
BAJA DEFINITIVA
2008-01-25T12:00:00-02:00
308
200804


INTERNOS-SEGUROS
30
BAJA DEFINITIVA
2005-09-12T12:00:00-03:00
365
200611


ADICIONAL
EMERG.CIGARRILLOS
1
ACTIVO
2008-01-28T12:00:00-02:00
366
200708

12
MARCELO NICOLAS
51

Pág. 12 de
30

AFIP- ws_sr_padron_a4
Especificaciones técnicas de Servicios Web

Versión:
Fecha:

1.1
12/12/16

REG.PER. IMPUESTO DE EMERGENCIA A LOS
AUTOMOTORES
Y
OTROS
FONDO
NACIONAL
DE
INCENTIVO
DOCENTE.
BAJA DEFINITIVA
64
715
200708
PERCEPCION

MASCULINO
CUIT
FISICA






Pág. 13 de
30

AFIP- ws_sr_padron_a4

Versión:

1.1

Fecha:

Especificaciones técnicas de Servicios Web

12/12/16

4. Definiciones de tipos de datos
4.1. Tipos de datos simples
Los datos simples tienen una longitud determinada. Según el tipo base se
pueden dar los siguientes casos:
• Longitud N: El campo tiene longitud fija de N dígitos o caracteres.
• Longitud M-N: El campo tiene longitud variable de tamaño M a N, siendo
M
Source Exif Data: 
File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.4
Linearized                      : No
Page Count                      : 29
Language                        : es-AR
Title                           : AFIP
Author                          : AFIP
Creator                         : Writer
Producer                        : LibreOffice 4.2
Create Date                     : 2016:12:12 15:30:49-03:00

EXIF Metadata provided by EXIF.tools