AFIP WSCDC Manual

AFIP-SDG SIT
Constatacin de Comprobantes
Manual para el desarrollador
Revisin correspondiente al 25 de Septiembre de 2013
Administracin Federal de Ingresos Pblicos

Subdireccin General de Sistemas y Telecomunicaciones
Buenos Aires
25 de Septiembre de 2013
Pgina 1 de 27
Especificaciones tcnicas de Servicios Web WSCDC
Historial de modificaciones
Ver
Fecha
Edicin
0.1
25-09-2013 SDG SIT/DIF
Descripcin
Versin inicial del documento
Pgina 2 de 27
Contenido
1 INTRODUCCIN ........................................................................................................................................... 4
1.1 OBJETIVO...................................................................................................................................................... 4
1.2 ALCANCE ...................................................................................................................................................... 4
1.3 TRATAMIENTO DE ERRORES EN EL WS ............................................................................................................ 4
1.4 TRATAMIENTO DE EVENTOS ............................................................................................................................ 5
1.5 DIRECCIN URL............................................................................................................................................ 5
2 WS DE NEGOCIO ......................................................................................................................................... 6
2.1 OPERACIONES............................................................................................................................................... 6
2.2 MTODO DE CONSTATACIN DE COMPROBANTES (COMPROBANTECONSTATAR) ............................................... 6
2.2.1 DIRECCIN URL (HOMOLOGACIN) ............................................................................................................ 6
2.2.2 MENSAJE DE SOLICITUD.............................................................................................................................. 6
2.2.3 MENSAJE DE RESPUESTA ........................................................................................................................... 8
2.2.4 VALIDACIONES Y ERRORES ....................................................................................................................... 11
2.2.5 OPERATORIA ANTE ERRORES .................................................................................................................... 14
2.2.6 EJEMPLOS ............................................................................................................................................... 15
COMPROBANTE DE MODALIDAD CAE CONSTATADO CORRECTAMENTE. .................................................................... 15
2.3 RECUPERADOR DE MODALIDADES DE AUTORIZACIN DE COMPROBANTES
(COMPROBANTESMODALIDADCONSULTAR) ............................................................................................................ 19
2.3.1 DIRECCIN URL (HOMOLOGACIN) .......................................................................................................... 19
2.3.2 MENSAJE DE SOLICITUD............................................................................................................................ 19
2.3.3 MENSAJE DE RESPUESTA ......................................................................................................................... 19
2.4 RECUPERADOR DE VALORES REFERENCIALES DE CDIGOS DE TIPOS DE COMPROBANTE
(COMPROBANTESTIPOCONSULTAR) ....................................................................................................................... 20
2.5 RECUPERADOR DE VALORES REFERENCIALES DE CDIGOS DE TIPOS DE DOCUMENTOS
(DOCUMENTOSTIPOCONSULTAR) ........................................................................................................................... 22
2.6 RECUPERADOR DE VALORES REFERENCIALES DE CDIGOS DE TIPOS DE DATOS OPCIONALES
(OPCIONALESTIPOCONSULTAR) ............................................................................................................................. 24
2.7 MTODO DUMMY PARA VERIFICACIN DE FUNCIONAMIENTO DE INFRAESTRUCTURA (COMPROBANTEDUMMY) ... 26
2.8 MARGEN DE ERROR MEDIANTE (ERROR ABSOLUTO Y ERROR RELATIVO) ....................................................... 27
Pgina 3 de 27
1 Introduccin
1.1
Objetivo
Este documento esta dirigido a quienes tengan que desarrollar el software cliente consumidor de
los WebServices correspondientes al servicio de Constatacin de Comprobantes.
1.2
Alcance
Este documento brinda las especificaciones tcnicas para desarrollar el cliente de WebServices
para usar el WSCDC. Debe complementarse con los documentos relativos a: Servicio de
Autenticacin y Autorizacin y Establecimiento del canal de comunicacin.
1.3
Tratamiento de errores en el WS
El tratamiento de errores en todos los servicios se realizar de la siguiente manera:

<Errors>
<Err>
<Code>int</Code>
<Msg>string</Msg>
</Err>
<Err>
<Code>int</Code>
<Msg>string</Msg>
</Err>
</Errors>
donde:
Campo
Errors
Detalle
Array de objeto. Err Informacin correspondiente a
errores
Obligatorio
N
Code
Cdigo de error
Msg
Mensaje descriptivo del error
Para errores internos de infraestructura, los errores se devuelven en la misma estructura (Errors).
Los cdigos de error son:
Cdigo de error
Error interno de aplicacin.
500
Causa
501
Error interno de base de datos.
502
Transaccin Activa
503
No existen datos en nuestros registros.
Pgina 4 de 27
1.4
Tratamiento de eventos
El tratamiento de eventos en todos los servicios se realizar de la siguiente manera:

<Events>
<Evt>
<Code>int</Code>
<Msg>string</Msg>
</Evt>
<Evt>
<Code>int</Code>
<Msg>string</Msg>
</Evt>
</Events>
donde:
Campo
Events
Detalle
Array de objeto. Evt Informacin correspondiente al
mensaje
Obligatorio
N
Code
Cdigo de evento
Msg
Detalla el evento que se desea comunicar
1.5
Direccin URL
Este servicio se llama en Homologacin desde:
https://wswhomo.afip.gov.ar/WSCDC/service.asmx
Para visualizar el WSDL en Homologacin:
https://wswhomo.afip.gov.ar/WSCDC/service.asmx?WSDL
Este servicio se llama en Produccin desde:
https://servicios1.afip.gov.ar/WSCDC/service.asmx
Para visualizar el WSDL en Produccin:
https://servicios1.afip.gov.ar/WSCDC/service.asmx?WSDL
Pgina 5 de 27
2 WS de Negocio
2.1
Operaciones
2.4.1 Operaciones a realizar segn la RG de aplicacin.

Mtodo de Constatacin de Comprobantes (ComprobanteConstatar).
Mtodo que determina las distintas modalidades por las que puede ser autorizado un
comprobante (ComprobantesModalidadConsultar).
Recuperador de valores referenciales de cdigos de Tipos de comprobante
(ComprobantesTipoConsultar)
Mtodo Dummy para
(ComprobanteDummy)
verificacin
de
funcionamiento
de
infraestructura
Recuperador de valores referenciales de cdigos de Tipos de Documentos

(DocumentosTipoConsultar)
Recuperador de valores referenciales de cdigos de Tipos de datos Opcionales
(OpcionalesTipoConsultar)
2.2
Mtodo de Constatacin de Comprobantes (ComprobanteConstatar)
El cliente ws enva la informacin del comprobante que desea constatar mediante un requerimiento
el cual es atendido por WSCDC pudiendo producirse las siguientes situaciones:
Supere todas las validaciones, se constata que el comprobante se encuentra registrado
y autorizado, o si aun no fue rendido.
No supere alguna de las validaciones de formato o funcionales, la constatacin es
rechazada.
Aclaracin: Los comprobantes pueden ser constatados por el emisor, por el receptor, o por
cualquiera que tenga acceso al ws e invoque el mtodo de constatacin enviando en el request los
datos mnimos e indispensables que lo identifican de forma.
2.2.1
Direccin URL (Homologacin)
Este servicio se llama desde:

https://wswhomo.afip.gov.ar/WSCDC/service.asmx?op=ComprobanteConstatar
2.2.2
Mensaje de solicitud
Recibe la informacin de un comprobante.

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ComprobanteConstatar>
<Auth>
<Token>string</Token>
<Sign>string</Sign>
<Cuit>long</Cuit>
</Auth>
Pgina 6 de 27
<CmpReq>
<CbteModo>string</CbteModo>
<CuitEmisor>long</CuitEmisor>
<PtoVta>int</PtoVta>
<CbteTipo>int</CbteTipo>
<CbteNro>long</CbteNro>
<CbteFch>string</CbteFch>
<ImpTotal>double</ImpTotal>
<CodAutorizacion>string</CodAutorizacion>
<DocTipoReceptor>string</DocTipoReceptor>
<DocNroReceptor>string</DocNroReceptor>
<Opcionales>
<Opcional>
<Id>string</Id>
<Valor>string</Valor>
</Opcional>
<Opcional>
<Id>string</Id>
</Opcional>
</Opcionales>
</CmpReq>
</ComprobanteConstatar>
</soap:Body>
</soap:Envelope>
donde:
Campo
Auth
Detalle
Informacin de la autenticacin. Contiene los datos de
Token, Sign y Cuit
Obligatorio
S
Token
Token devuelto por el WSAA
Sign
Sign devuelto por el WSAA
Cuit
Cuit contribuyente
Campo
CmpReq
Detalle
Informacin del comprobante a constatar.
Obligatorio
S
CmpReq: La estructura del comprobante de entrada est compuesta por los siguientes campos:
Campo
Tipo
Detalle
Modalidad por la cual fue autorizado
el comprobante.
Obligatorio
CbteModo
String (4)
CuitEmisor
Long (11)
Cuit del emisor del comprobante a

constatar.
PtoVta
Int (4)
Punto de Venta del comprobante

que se est constatando.
CbteTipo
Int (3)
Tipo de comprobante
CbteNro
Long (8)
Nmero de comprobante
CbteFch
String (8)
Fecha del comprobante.
ImpTotal
Double (13+2)
Importe total del comprobante
Pgina 7 de 27
CodAutorizacion
String (14)
Codigo de autorizacin
DocTipoReceptor
String (2)
Tipo de documento del receptor del

comprobante
DocNroReceptor
String (20)
N de documento del receptor del

comprobante
Opcionales
Array
Array de campos auxiliares.

Reservado usos futuros <Opcional>.
Opcionales: Campos auxiliares (array).

Campo reservado para usos futuros. El listado de tipos de datos opcionales se puede consultar con
el mtodo OpcionalesTipoConsultar.
Campo
Tipo
Detalle
Obligatorio
Id
String(4)
Cdigo de Opcional, consultar mtodo

OpcionalesTipoConsultar
Valor
String (250)
Valor
2.2.3
Mensaje de respuesta
Retorna los datos del comprobante ingresados con la constatacin correspondiente.

Superadas las validaciones Excluyentes se retorna el tag <Resultado>A</Resultado>, en caso de
no superar alguna de las validaciones NO excluyentes adems devuelve un array de
observaciones.
De no superar las validaciones Excluyentes (Formato) se retorna el tag <Resultado>R</Resultado>,
y un array de errores.
De no superar las validaciones Excluyentes (Funcionales)
<Resultado>R</Resultado>, y un array de observaciones.
se
retorna
el
tag
Cabe aclarar que las validaciones excluyentes son aquellas que en el caso de no ser superadas
provocan un rechazo y las validaciones no excluyentes aprueban la solicitud pero con
observaciones.

<soap:Body>
<ComprobanteConstatarResponse>
<ComprobanteConstatarResult>
<CmpResp>
<CbteModo>string</CbteModo>
<CuitEmisor>long</CuitEmisor>
<PtoVta>int</PtoVta>
<CbteTipo>int</CbteTipo>
<CbteNro>long</CbteNro>
<CbteFch>string</CbteFch>
<ImpTotal>double</ImpTotal>
<CodAutorizacion>string</CodAutorizacion>
<DocTipoReceptor>string</DocTipoReceptor>
<DocNroReceptor>string</DocNroReceptor>
<Opcionales>
<Opcional>
<Id>string</Id>
Pgina 8 de 27
</Opcional>
<Opcional>
<Id>string</Id>
</Opcional>
</Opcionales>
</CmpResp>
<Resultado>string</Resultado>
<Observaciones>
<Obs>
<Code>int</Code>
<Msg>string</Msg>
</Obs>
<Obs>
<Code>int</Code>
<Msg>string</Msg>
</Obs>
</Observaciones>
<FchProceso>string</FchProceso>
<Events>
<Evt>
<Code>int</Code>
<Msg>string</Msg>
</Evt>
<Evt>
<Code>int</Code>
<Msg>string</Msg>
</Evt>
</Events>
<Errors>
<Err>
<Code>int</Code>
<Msg>string</Msg>
</Err>
<Err>
<Code>int</Code>
<Msg>string</Msg>
</Err>
</Errors>
</ComprobanteConstatarResult>
</ComprobanteConstatarResponse>
</soap:Body>
</soap:Envelope>
donde:
Campo
Detalle
Obligatorio
ComprobanteConstat
arResult
Contiene los datos del comprobante constatado +

respuesta. De corresponder, contiene errores y
observaciones.
CmpResp
Contiene los datos del comprobante enviado a

constatar
Resultado
Resultado de la constatacin del comprobante. A =

Autorizado, R=Rechazado.
FchProceso
Fecha en la que se realizo la constatacin.
Observaciones
Informacin de observaciones detectadas
Errors
Informacin de errores detectados
Events
Informacin de eventos
Pgina 9 de 27
CmpResp: La estructura del comprobante de salida est compuesta por los siguientes campos:
Campo
Tipo
Detalle
Modalidad por la cual fue autorizado
el comprobante.
Obligatorio
CbteModo
String (4)
CuitEmisor
Long (11)
Cuit del emisor del comprobante a

constatar.
PtoVta
Int (4)
Punto de Venta del comprobante que

se est constatando.
CbteTipo
Int (3)
Tipo de comprobante
CbteNro
Long (8)
Nmero de comprobante
CbteFch
String (8)
Fecha del comprobante.
ImpTotal
Double (13+2)
Importe total del comprobante
CodAutorizacion
String (14)
Cdigo de autorizacin
DocTipoReceptor
String (2)
Tipo de documento del receptor del

comprobante
DocNroReceptor
String (20)
N de documento del receptor del

comprobante
Opcionales
Array
Array de campos auxiliares.

Reservado usos futuros <Opcional>.
Opcionales: Campos auxiliares (array). Adicionales por R.G.

Campo reservado para usos futuros. El listado de tipos de datos opcionales se puede consultar con
el mtodo OpcionalesTipoConsultar.
Campo
Tipo
Detalle
Obligatorio
Id
String(4)
Cdigo de Opcional, consultar mtodo

OpcionalesTipoConsultar
Valor
String (250)
Valor
Observaciones: La estructura de datos Obs muestra el detalle de observaciones para un

comprobante determinado; estar compuesta por los siguientes campos:
Campo
Tipo
Detalle
Obligatorio
Code
Int (5)
Cdigo de observacin
Msg
String (255)
Mensaje
Pgina 10 de 27
2.2.4
Validaciones y errores
Controles aplicados al objeto <Auth>

Validaciones Excluyentes
Campo /
Grupo
Cdigo de
error
Descripcin de la validacin
<Cuit>
600
No se corresponden token y firma. Usuario no autorizado a realizar

esta operacin
<Cuit>
601
CUIT representada no incluida en token.
<Cuit>
602
CUIT representada no se encuentre activa y vigente.
Controles aplicados al objeto <CmpReq>

Validaciones Excluyentes (Formato)
Cdigo
de error
<CbteModo>
El modo indicado debe ser alfanumrico de 4

caracteres como mximo y debe ser alguno de los
devueltos
por
el
mtodo
ComprobantesModalidadConsultar()
<CuitEmisor>
La cuit del emisor indicado debe ser numrica de 11

dgitos y debe ser valida.
<PtoVta>
Campo <PtoVta> debe ser numrico de 4 dgitos

como mximo y debe estar comprendido entre 1 y
9998.
<CbteTipo>
El tipo de comprobante debe ser numrico de 3

dgitos como mximo y debe ser alguno de los
definidos
en
el
mtodo
ComprobantesTipoConsultar()
<CbteNro>
Campo correspondiente al N de comprobante,

debe ser numrico de 8 dgitos como mximo y se
debe encontrar entre 1 y 99999999.
<CbteFch>
Campo correspondiente a la fecha del comprobante,

debe tener el siguiente formato yyyymmdd
<ImpTotal>
Campo correspondiente al importe total del

comprobante. Debe ser numrico mayor o igual a 0
de 13 enteros y 2 decimales.
El tipo de documento del receptor debe ser

numrico de 2 dgitos y debe ser alguno de los
devueltos
por
el
mtodo
DocumentosTipoConsultar().
<DocNroReceptor>
El nmero de documento del receptor, debe

contener un valor numrico de 11 caracteres. Si el
nmero del doucumento contiene letras no
informarlas, solamente informar los caracteres
numricos.
<CodAutorizacion>
10
Cdigo de autorizacin del comprobante, debe ser

de 14 caracteres numricos.
Campo / Grupo
<DocTipoReceptor>
Pgina 11 de 27
Validaciones Excluyentes (Funcionales)
Campo / Grupo
<CodAutorizacion>
<CbteFch>
<CodAutorizacion>/<CuitEmisor>
<CodAutorizacion>/<CbteTipo>
<CodAutorizacion>/<PtoVta>
<CodAutorizacion>/<CbteNro>
Cdigo
de error
100
Verificar que el CAE/CAI/CAEA

exista registrado y autorizado
en las bases del organismo.
101
102
Verifica que la CUIT del emisor

informada se corresponda con
la cuit registrada bajo el cdigo
de
autorizacin
<CodAutorizacion>.
103
Verifica que el tipo de

comprobante <CbteTipo> se
corresponda con el registrado
bajo el cdigo de autorizacin
informado <CodAutorizacion>
104
Verifica que el punto de venta

<PtoVta> se corresponda con
el punto de venta registrado
105
Verifica
que
el
N
de
comprobante <CbteNro> se
corresponda con el N de
comprobante registrado bajo el
cdigo
de
autorizacin
106
Para modo <CbteModo> =

CAEA , en caso de no
encontrar
el
comprobante
rendido,
verifica
que
se
encuentre vigente la rendicin
del mismo.
107

CAE o <CbteModo> =
CAEA, verifica que la fecha
del comprobante <CbteFch> se
corresponda con el cdigo de
autorizacin
informado
<CodAutorizacion>
108

CAI verifica que la fecha del
comprobante <CbteFch> se
encuentre dentro del rango
habilitado para el cdigo de
autorizacin
informado
<CodAutorizacion>
<CbteModo>/
<CodAutorizacion>/
<CbteModo>/
<CodAutorizacion>/
<CbteFch>
<CbteModo>/
<CodAutorizacion>/
<CbteFch>
La fecha del comprobante

<CbteFch> no podr ser
anterior a 20130101.
Pgina 12 de 27
Campo / Grupo
Cdigo
de error
109

CAEA, verifica que el punto
de venta sea un punto de venta
habilitado
para
emitir
comprobantes.
<CbteModo>/
<CodAutorizacion>/
<PtoVta>
Verificar que el importe de la

operacin
informado
se
corresponda con lo registrado
en las bases del organismo.
<CbteModo>/
<CodAutorizacion>/
110
<ImpTotal>
Para los tipos de comprobantes

sin ImpTotal se debe informar
el campo en cero.
Margen de error:
Error relativo porcentual deber
ser <= 0.01% o el error
absoluto <=1.
<CodAutorizacion>/<DocTipoReceptor>
<CodAutorizacion>/<DocNroReceptor>
<CbteTipo><DocTipoReceptor>
<CbteTipo<DocNroReceptor>
111
Verifica que el tipo de

documento
del
receptor
<DocTipoReceptor>
se
112
Verifica que el nmero de

documento
del
receptor
<DocNroReceptor>
se
113
Para comprobantes tipo A o

tipo M, el tipo de documento
del receptor es obligatorio
informarlo y debe ser CUIT
(CbteTipo = 80).
114
<CbteTipo><DocTipoReceptor>
115
<CbteTipo><DocNroReceptor>
<CbteTipo><DocTipoReceptor>><DocNroReceptor>
Para comprobantes tipo A o

tipo M, el N de documento del
receptor
es
obligatorio
informarlo.
Para comprobantes tipo B, C ,
R, 31, 30, 37, 38, 41 y 49 el
tipo de documento del receptor
solo es obligatorio informarlo
cuando el importe es superior a
1000 pesos.
116
Para comprobantes tipo B, C ,

R, 31, 30, 37, 38, 41 y 49 , el
nmero de documento del
receptor solo es obligatorio
informarlo cuando el importe es
superior a 1000 pesos.
117
Si informa <DocTipoReceptor>
o
<DocNroReceptor>
es
Pgina 13 de 27
Campo / Grupo
Cdigo
de error
obligatorio informar ambos.
150
Si
enva
<Opcionales>,
<Opcional> es obligatorio.
<Opcional>
151
El
campo
<Id>
en
<Opcionales> es obligatorio y
debe ser alguno de los
devueltos por
el
mtodo
OpcionalesTipoConsultar.
<Opcional>
152
El
campo
<Id>
en
<Opcionales> es obligatorio y
no debe repetirse."
<Opcional>
153
El campo
<Valor>
Opcionales es obligatorio
<Opcionales>
en
Validaciones NO Excluyentes (Funcionales)
Campo / Grupo
<CodAutorizacion>
2.2.5
Cdigo
de error
200

CAEA , en caso de no
encontrar
el
comprobante
rendido,
verifica
que
se
encuentre vigente la rendicin
del mismo. Si se encuentra en
vigencia el comprobante queda
observado por no encontrarse
rendido.
Operatoria ante errores
Para la operatoria del mtodo ComprobanteConstatar se describe la metodologa sugerida ante

rechazos.
Los rechazos por formato devolvern en el tag Errors todas las causas involucradas.
Los rechazos por validaciones funcionales se devolvern en el tag Observaciones todas las causas
involucradas.
Operatoria con errores de comunicacin:
En el diseo del WSCDC se ha previsto que -dada la complejidad actual de las comunicacionespueden ocurrir interrupciones en la comunicacin entre el cliente y el WSCDC bsicamente, el
problema podra resumirse al siguiente escenario: el cliente enva una solicitud de constatacin al
WSCDC y se queda esperando una respuesta que no llega, hasta que transcurrido algn tiempo, se
produce una condicin de time-out.
En ese caso, el usuario no sabr si la solicitud lleg al WSCDC, y la falla de comunicacin se
produjo durante el retorno de la informacin, o bien si la falla ocurri durante el envo de la solicitud
y simplemente WSCDC nunca la recibi.
En ambos casos con simplemente enviar la misma solicitud todo quedara resuelto.
Pgina 14 de 27
2.2.6
Ejemplos
Comprobante de modalidad CAE constatado correctamente.

REQUEST
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:wsf="http://servicios1.afip.gob.ar/wscdc/">
<soapenv:Header/>
<soapenv:Body>
<Auth>
<Token>111</Token>
<Sign>11111111</Sign>
<Cuit>300000000007</Cuit>
</Auth>
<CmpReq>
<CbteModo>CAE</CbteModo>
<CuitEmisor>20000000001</CuitEmisor>
<PtoVta>1</PtoVta>
<CbteTipo>1</CbteTipo>
<CbteNro>2</CbteNro>
<CbteFch>20101014</CbteFch>
<ImpTotal>300.8</ImpTotal>
<CodAutorizacion>60428000005029</CodAutorizacion>
<DocTipoReceptor>80</DocTipoReceptor>
<DocNroReceptor>300000000007</DocNroReceptor>
</CmpReq>
</soapenv:Body>
</soapenv:Envelope>
RESPONSE
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<CmpResp>
<PtoVta>1</PtoVta>
</CmpResp>
<Resultado>A</Resultado>
<FchProceso>20130729204436</FchProceso>
</soap:Body>
</soap:Envelope>
Pgina 15 de 27
Comprobante de modalidad CAEA aun no informado, dentro de la fecha de vigencia de tope para
informar. Devuelve una observacin en el array de observaciones, pero no Rechaza.
REQUEST
<soapenv:Envelope
<soapenv:Header/>
<soapenv:Body>
<Auth>
<Token>111</Token>
<Sign>11111111</Sign>
<Cuit>30000000007</Cuit>
</Auth>
<CmpReq>
<CbteModo>CAEA</CbteModo>
<PtoVta>1112</PtoVta>
<ImpTotal>2600</ImpTotal>
</CmpReq>
</soapenv:Body>
</soapenv:Envelope>
RESPONSE
<soap:Envelope
<soap:Body>
<CmpResp>
<CbteModo>CAEA</CbteModo>
<PtoVta>1112</PtoVta>
<ImpTotal>2600</ImpTotal>
</CmpResp>
<Resultado>A</Resultado>
<Observaciones>
<Obs>
<Code>200</Code>
<Msg>Existe CAEA, no fue rendido o no coincide
con los datos registrados.</Msg>
</Obs>
</Observaciones>
</soap:Body>
</soap:Envelope>
Pgina 16 de 27
Comprobante de modalidad CAE con errores de validaciones de formato devuelto en el array de

Errors.
REQUEST
<soapenv:Envelope
<soapenv:Header/>
<soapenv:Body>
<Auth>
<Token>111</Token>
<Sign>11111111</Sign>
<Cuit>300000000007</Cuit>
</Auth>
<CmpReq>
<PtoVta>1</PtoVta>
</CmpReq>
</soapenv:Body>
</soapenv:Envelope>
RESPONSE
<soap:Envelope
<soap:Body>
<CmpResp>
<PtoVta>1</PtoVta>
</CmpResp>
<Resultado>R</Resultado>
<Errors>
<Err>
<Code>2</Code>
<Msg>El campo CuitEmisor es invalido.</Msg>
</Err>
</Errors>
</soap:Body>
</soap:Envelope>
Pgina 17 de 27
Comprobante de modalidad CAI con errores de validaciones de negocio devuelto en el array de

Observaciones.
REQUEST
<soapenv:Envelope
<soapenv:Header/>
<soapenv:Body>
<Auth>
<Token>111</Token>
<Sign>11111111</Sign>
<Cuit>300000000007</Cuit>
</Auth>
<CbteModo>CAI</CbteModo>
<PtoVta>63</PtoVta>
</soapenv:Body>
</soapenv:Envelope>
RESPONSE
<soap:Envelope
<soap:Body>
<CmpResp>
<CbteModo>CAI</CbteModo>
<PtoVta>63</PtoVta>
</CmpResp>
<Resultado>R</Resultado>
<Observaciones>
<Obs>
<Code>108</Code>
<Msg>La fecha consignada no se encuentra dentro
del rango de fechas habilitadas para el CAI ingresado</Msg>
</Obs>
</Observaciones>
</soap:Body>
</soap:Envelope>
Pgina 18 de 27
2.3
Recuperador de modalidades de autorizacin de comprobantes

(ComprobantesModalidadConsultar)
Este mtodo permite obtener las distintas modalidades de autorizacin que se encuentran
habilitadas a consultar.
2.3.1

https://wswhomo.afip.gov.ar/WSCDC/service.asmx?op=ComprobantesModalidadConsultar
2.3.2
Recibe las credenciales de autenticacin y la cuit del usuario representado.

<?xml version="1.0" encoding="utf-8"?>
<soap:Body>
<ComprobantesModalidadConsultar>
<Auth>
<Sign>string</Sign>
<Cuit>long</Cuit>
</Auth>
</ComprobantesModalidadConsultar>
</soap:Body>
</soap:Envelope>
donde:
Campo
Detalle
Obligatorio
Auth
Informacin de la autenticacin. Contiene los datos

de Token, Sign , Cuit
Token
Sign
Cuit
Cuit contribuyente
2.3.3
Retorna el universo de modalidades vlidas.

<soap:Body>
<ComprobantesModalidadConsultarResponse>
<ComprobantesModalidadConsultarResult>
<ResultGet>
<FacModTipo>
<Cod>string</Cod>
<Desc>string</Desc>
</FacModTipo>
</ResultGet>
<Errors>
<Err>
Pgina 19 de 27
<Code>int</Code>
<Msg>string</Msg>
</Err>
</Errors>
<Events>
<Evt>
<Code>int</Code>
<Msg>string</Msg>
</Evt>
</Events>
</ComprobantesModalidadConsultarResult>
</ComprobantesModalidadConsultarResponse>
</soap:Body>
</soap:Envelope>
donde:
ComprobantesModalidadConsultarResult:
Campo
Detalle
Obligatorio
ResultGet
Informacin de los diferentes modos permitidos.
Errors
Events
ResultGet: Detalle de los modos de autorizacin; esta compuesto por los siguientes campos:
Campo
Tipo
Detalle
Obligatorio
Cod
String (4)
Cdigo de autorizacin
Desc
String (250)
Descripcin de autorizacin
2.4
Recuperador de valores referenciales de cdigos de Tipos de comprobante

(ComprobantesTipoConsultar)
Este mtodo permite consultar los tipos de comprobantes habilitados en este WS.
2.4.1

https://wswhomo.afip.gov.ar/WSCDC/service.asmx?op=ComprobantesTipoConsultar
2.4.2

<soap:Body>
<ComprobantesTipoConsultar>
<Auth>
<Sign>string</Sign>
<Cuit>long</Cuit>
</Auth>
</ComprobantesTipoConsultar>
</soap:Body>
</soap:Envelope>
Pgina 20 de 27
donde:
Campo
Detalle
Obligatorio
Auth

Token
Sign
Cuit
Cuit contribuyente
2.4.3
Retorna el universo de tipos de comprobante validos.

<soap:Body>
<ComprobantesTipoConsultarResponse>
<ComprobantesTipoConsultarResult>
<ResultGet>
<CbteTipo>
<Id>int</Id>
<Desc>string</Desc>
<FchDesde>string</FchDesde>
<FchHasta>string</FchHasta>
</CbteTipo>
<CbteTipo>
<Id>int</Id>
<Desc>string</Desc>
</CbteTipo>
</ResultGet>
<Errors>
<Err>
<Code>int</Code>
<Msg>string</Msg>
</Err>
<Err>
<Code>int</Code>
<Msg>string</Msg>
</Err>
</Errors>
<Events>
<Evt>
<Code>int</Code>
<Msg>string</Msg>
</Evt>
<Evt>
<Code>int</Code>
<Msg>string</Msg>
</Evt>
</Events>
</ComprobantesTipoConsultarResult>
</ComprobantesTipoConsultarResponse>
</soap:Body>
</soap:Envelope>
Pgina 21 de 27
donde:
ComprobantesTipoConsultarResult:
Campo
Detalle
Obligatorio
ResultGet
Informacin de los diferentes tipos de comprobantes

permitidos.
Errors
Events
ResultGet: Detalle de los tipos de comprobantes; esta compuesto por los siguientes campos:
Campo
Tipo
Detalle
Obligatorio
Id
Int (3)
Cdigo de comprobante
Desc
String (250)
Descripcin
FchDesde
String (8)
Fecha de vigencia desde
FchHasta
String (8)
Fecha de vigencia hasta
2.5
Recuperador de valores referenciales de cdigos de Tipos de Documentos

(DocumentosTipoConsultar)
Este mtodo retorna el universo de tipos de documentos disponibles en el presente WS.

2.5.1

https://wswhomo.afip.gov.ar/WSCDC/service.asmx?op=DocumentosTipoConsultar
2.5.2

<soap:Body>
< DocumentosTipoConsultar>
<Auth>
<Sign>string</Sign>
<Cuit>long</Cuit>
</Auth>
</DocumentosTipoConsultar>
</soap:Body>
</soap:Envelope>
donde:
Campo
Detalle
Obligatorio
Auth

Token
Sign
Cuit
Cuit contribuyente
Pgina 22 de 27
2.5.3
<soap:Body>
<DocumentosTipoConsultarResponse>
<DocumentosTipoConsultarResult>
<ResultGet>
<DocTipo>
<Id>int</Id>
<Desc>string</Desc>
</DocTipo>
<DocTipo>
<Id>int</Id>
<Desc>string</Desc>
</DocTipo>
</ResultGet>
<Errors>
<Err>
<Code>int</Code>
<Msg>string</Msg>
</Err>
<Err>
<Code>int</Code>
<Msg>string</Msg>
</Err>
</Errors>
<Events>
<Evt>
<Code>int</Code>
<Msg>string</Msg>
</Evt>
<Evt>
<Code>int</Code>
<Msg>string</Msg>
</Evt>
</Events>
</DocumentosTipoConsultarResult>
</DocumentosTipoConsultarResponse>
</soap:Body>
</soap:Envelope>
donde:
DocumentosTipoConsultarResult:
Campo
Detalle
Obligatorio
ResultGet
Informacin sobre los tipos de documento aceptados.
Errors
Events
ResultGet:
Campo
Tipo
Detalle
Obligatorio
Id
Int (2)
Cdigo de tipo de documento
Desc
String (250)
Descripcin
FchDesde
String(8)
FchHasta
String (8)
Pgina 23 de 27
2.6
Recuperador de valores referenciales de cdigos de Tipos de datos Opcionales

(OpcionalesTipoConsultar)
Este mtodo permite consultar los cdigos y descripciones de los tipos de datos Opcionales que se
encuentran habilitados para ser usados en el WS.
2.6.1

https://wswhomo.afip.gov.ar/WSCDC/service.asmx?op=OpcionalesTipoConsultar
2.6.2

<soap:Body>
<OpcionalesTipoConsultar>
<Auth>
<Sign>string</Sign>
<Cuit>long</Cuit>
</Auth>
</OpcionalesTipoConsultar>
</soap:Body>
</soap:Envelope>
donde:
Campo
Detalle
Obligatorio
Auth
Informacin de la autenticacin. Contiene los

datos de Token, Sign , Cuit
Token
Sign
Cuit
Cuit contribuyente
2.6.3
<soap:Body>
<OpcionalesTipoConsultarResponse>
<OpcionalesTipoConsultarResult>
<ResultGet>
<OpcionalTipo>
<Id>string</Id>
<Desc>string</Desc>
</OpcionalTipo>
<OpcionalTipo>
<Id>string</Id>
<Desc>string</Desc>
Pgina 24 de 27
</OpcionalTipo>
</ResultGet>
<Errors>
<Err>
<Code>int</Code>
<Msg>string</Msg>
</Err>
<Err>
<Code>int</Code>
<Msg>string</Msg>
</Err>
</Errors>
<Events>
<Evt>
<Code>int</Code>
<Msg>string</Msg>
</Evt>
<Evt>
<Code>int</Code>
<Msg>string</Msg>
</Evt>
</Events>
</OpcionalesTipoConsultarResult>
</OpcionalesTipoConsultarResponse>
</soap:Body>
</soap:Envelope>
donde:
OpcionalesTipoConsultarResult:
Campo
Detalle
Obligatorio
ResultGet
Informacin de los tipos de datos opcionales
Errors
Events
ResultGet: Detalle de los tipos de datos opcionales; esta compuesto por los siguientes campos:
Campo
Tipo
Detalle
Obligatorio
Id
String (4)
Identificador de campo opcional
Desc
String (250)
Descripcin
FchDesde
String (8)
FchHasta
String (8)
Pgina 25 de 27
2.7
Mtodo Dummy para verificacin de funcionamiento de infraestructura

(ComprobanteDummy)
2.7.1 Direccin URL (Homologacin)

https://wswhomo.afip.gov.ar/WSCDC/service.asmx?op=ComprobanteDummy
2.7.2 Mensaje de solicitud

El mtodo no posee parmetros de ingreso
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header/>
<soapenv:Body>
<wsc:ComprobanteDummy/>
</soapenv:Body>
</soapenv:Envelope>
2.7.3 Mensaje de respuesta

Retorna la comprobacin va ping de los elementos principales de infraestructura del servicio.
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header/>
<soapenv:Body>
<ComprobanteDummyResponse>
<ComprobanteDummyResult>
<AppServer>string</AppServer>
<DbServer>string</DbServer>
<AuthServer>string</AuthServer>
</ComprobanteDummyResult>
</ComprobanteDummyResponse>
</soapenv:Body>
</soapenv:Envelope>
donde:
Campo
Tipo
Detalle
Obligatorio
AppServer
String (2)
Servidor de aplicaciones
DbServer
String (2)
Servidor de base de datos
AuthServer
String (2)
Servidor de autenticacin
Pgina 26 de 27
2.8
Margen de error mediante (Error Absoluto y Error Relativo)
Error Absoluto eabs: Es la diferencia entre el valor medido informado y el valor real
Error Relativo erel : Es el cociente entre el valor error absoluto y el valor real.
En ambos casos se tomar el valor absoluto, es decir el signo resultante de la operacin no
se considerar.
El criterio de redondeo que utilizamos en este servicio es Round Half Even.
Pgina 27 de 27

AFIP WSCDC Manual

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

AFIP WSCDC Manual

Uploaded by

Copyright:

Available Formats

AFIP-SDG SIT

Administracin Federal de Ingresos Pblicos

Especificaciones tcnicas de Servicios Web WSCDC

25-09-2013 SDG SIT/DIF

Versin inicial del documento

Especificaciones tcnicas de Servicios Web WSCDC

Especificaciones tcnicas de Servicios Web WSCDC

El tratamiento de errores en todos los servicios se realizar de la siguiente manera:

Mensaje descriptivo del error

Error interno de base de datos.

No existen datos en nuestros registros.

Especificaciones tcnicas de Servicios Web WSCDC

El tratamiento de eventos en todos los servicios se realizar de la siguiente manera:

Detalla el evento que se desea comunicar

Especificaciones tcnicas de Servicios Web WSCDC

2.4.1 Operaciones a realizar segn la RG de aplicacin.

Recuperador de valores referenciales de cdigos de Tipos de Documentos

Mtodo de Constatacin de Comprobantes (ComprobanteConstatar)

Direccin URL (Homologacin)

Este servicio se llama desde:

Recibe la informacin de un comprobante.

Especificaciones tcnicas de Servicios Web WSCDC

Token devuelto por el WSAA

Sign devuelto por el WSAA

Cuit del emisor del comprobante a

Punto de Venta del comprobante

Fecha del comprobante.

Importe total del comprobante

Especificaciones tcnicas de Servicios Web WSCDC

Tipo de documento del receptor del

N de documento del receptor del

Array de campos auxiliares.

Opcionales: Campos auxiliares (array).

Cdigo de Opcional, consultar mtodo

Retorna los datos del comprobante ingresados con la constatacin correspondiente.

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"

Especificaciones tcnicas de Servicios Web WSCDC

Contiene los datos del comprobante constatado +

Contiene los datos del comprobante enviado a

Resultado de la constatacin del comprobante. A =

Fecha en la que se realizo la constatacin.

Informacin de observaciones detectadas

Informacin de errores detectados

Especificaciones tcnicas de Servicios Web WSCDC

Cuit del emisor del comprobante a

Punto de Venta del comprobante que

Fecha del comprobante.

Importe total del comprobante

Tipo de documento del receptor del

N de documento del receptor del

Array de campos auxiliares.

Opcionales: Campos auxiliares (array). Adicionales por R.G.

Cdigo de Opcional, consultar mtodo

Observaciones: La estructura de datos Obs muestra el detalle de observaciones para un

Especificaciones tcnicas de Servicios Web WSCDC

Controles aplicados al objeto <Auth>

No se corresponden token y firma. Usuario no autorizado a realizar

CUIT representada no incluida en token.

CUIT representada no se encuentre activa y vigente.

Controles aplicados al objeto <CmpReq>

El modo indicado debe ser alfanumrico de 4

La cuit del emisor indicado debe ser numrica de 11

Campo <PtoVta> debe ser numrico de 4 dgitos