Constatación de Comprobantes - AFIP

1 AFIP-SDG SIT. Constataci n de Comprobantes Manual para el desarrollador Revisi n correspondiente al 25 de Septiembre de 2013. Administraci n Federal de Ingresos P blicos Subdirecci n General de Sistemas y Telecomunicaciones Buenos Aires 25 de Septiembre de 2013. P gina 1 de 27. Especificaciones t cnicas de Servicios Web WSCDC. Historial de modificaciones Ver Fecha Edici n Descripci n 25-09-2013 SDG SIT/DIF Versi n inicial del documento P gina 2 de 27. Especificaciones t cnicas de Servicios Web WSCDC. Contenido 1 INTRODUCCI N .. 4. 4. ALCANCE .. 4. TRATAMIENTO DE ERRORES EN EL WS .. 4. TRATAMIENTO DE EVENTOS .. 5. DIRECCI N 5.

2 2 WS DE NEGOCIO .. 6. 6. M TODO DE CONSTATACI N DE Comprobantes (COMPROBANTECONSTATAR) .. 6. DIRECCI N URL (HOMOLOGACI N) .. 6. MENSAJE DE 6. MENSAJE DE RESPUESTA .. 8. VALIDACIONES Y ERRORES .. 11. OPERATORIA ANTE ERRORES .. 14. EJEMPLOS .. 15. COMPROBANTE DE MODALIDAD CAE CONSTATADO CORRECTAMENTE.. 15. RECUPERADOR DE MODALIDADES DE AUTORIZACI N DE Comprobantes . (COMPROBANTESMODALIDADCONSULTAR) .. 19. DIRECCI N URL (HOMOLOGACI N) .. 19. MENSAJE DE 19. MENSAJE DE RESPUESTA .. 19. RECUPERADOR DE VALORES REFERENCIALES DE C DIGOS DE TIPOS DE COMPROBANTE. (COMPROBANTESTIPOCONSULTAR) .. 20. DIRECCI N URL (HOMOLOGACI N).

3 20. MENSAJE DE 20. MENSAJE DE RESPUESTA .. 21. RECUPERADOR DE VALORES REFERENCIALES DE C DIGOS DE TIPOS DE DOCUMENTOS. (DOCUMENTOSTIPOCONSULTAR) .. 22. DIRECCI N URL (HOMOLOGACI N) .. 22. MENSAJE DE 22. MENSAJE DE RESPUESTA .. 23. RECUPERADOR DE VALORES REFERENCIALES DE C DIGOS DE TIPOS DE DATOS OPCIONALES. (OPCIONALESTIPOCONSULTAR) .. 24. DIRECCI N URL (HOMOLOGACI N) .. 24. MENSAJE DE 24. MENSAJE DE RESPUESTA .. 24. M TODO DUMMY PARA VERIFICACI N DE FUNCIONAMIENTO DE INFRAESTRUCTURA (COMPROBANTEDUMMY) .. 26. DIRECCI N URL (HOMOLOGACI N) .. 26. MENSAJE DE 26. MENSAJE DE RESPUESTA .. 26. MARGEN DE ERROR MEDIANTE (ERROR ABSOLUTO Y ERROR RELATIVO).

4 27. P gina 3 de 27. Especificaciones t cnicas de Servicios Web WSCDC. 1 Introducci n Objetivo Este documento esta dirigido a quienes tengan que desarrollar el software cliente consumidor de los WebServices correspondientes al servicio de Constataci n de Comprobantes . Alcance Este documento brinda las especificaciones t cnicas para desarrollar el cliente de WebServices para usar el WSCDC. Debe complementarse con los documentos relativos a: Servicio de Autenticaci n y Autorizaci n y Establecimiento del canal de comunicaci n . Tratamiento de errores en el WS. El tratamiento de errores en todos los servicios se realizar de la siguiente manera: <Errors>.

5 <Err>. <Code>int</Code>. <Msg>string</Msg>. </Err>. <Err>. <Code>int</Code>. <Msg>string</Msg>. </Err>. </Errors>. donde: Campo Detalle Obligatorio Array de objeto. Err Informaci n correspondiente a Errors N. errores Code C digo de error S. Msg Mensaje descriptivo del error S. Para errores internos de infraestructura, los errores se devuelven en la misma estructura (Errors). Los c digos de error son: C digo de error Causa 500 Error interno de aplicaci n. 501 Error interno de base de datos. 502 Transacci n Activa 503 No existen datos en nuestros registros. P gina 4 de 27. Especificaciones t cnicas de Servicios Web WSCDC.

6 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 Detalle Obligatorio Array de objeto. Evt Informaci n correspondiente al Events N. mensaje Code C digo de evento S. Msg Detalla el evento que se desea comunicar S. Direcci n URL. Este servicio se llama en Homologaci n desde: Para visualizar el WSDL en Homologaci n: Este servicio se llama en Producci n desde: Para visualizar el WSDL en Producci n: P gina 5 de 27. Especificaciones t cnicas de Servicios Web WSCDC.

7 2 WS de Negocio Operaciones Operaciones a realizar seg n la RG de aplicaci n. M todo de Constataci n de Comprobantes (ComprobanteConstatar). M todo que determina las distintas modalidades por las que puede ser autorizado un comprobante (ComprobantesModalidadConsultar). Recuperador de valores referenciales de c digos de Tipos de comprobante (ComprobantesTipoConsultar). M todo Dummy para verificaci n de funcionamiento de infraestructura (ComprobanteDummy). Recuperador de valores referenciales de c digos de Tipos de Documentos (DocumentosTipoConsultar). Recuperador de valores referenciales de c digos de Tipos de datos Opcionales (OpcionalesTipoConsultar).

8 M todo de Constataci n de Comprobantes (ComprobanteConstatar). El cliente ws env a la informaci n 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 constataci n es rechazada. Aclaraci n: Los Comprobantes pueden ser constatados por el emisor, por el receptor, o por cualquiera que tenga acceso al ws e invoque el m todo de constataci n enviando en el request los datos m nimos e indispensables que lo identifican de forma.

9 Direcci n URL (Homologaci n). Este servicio se llama desde: Mensaje de solicitud Recibe la informaci n de un comprobante. <soap:Envelope xmlns:xsi=" instance" xmlns:xsd=" ". xmlns:soap=" ">. <soap:Body>. <ComprobanteConstatar>. <Auth>. <Token>string</Token>. <Sign>string</Sign>. <Cuit>long</Cuit>. </Auth>. P gina 6 de 27. Especificaciones t cnicas de Servicios Web WSCDC. <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>.

10 <DocNroReceptor>string</DocNroReceptor>. <Opcionales>. <Opcional>. <Id>string</Id>. <Valor>string</Valor>. </Opcional>. <Opcional>. <Id>string</Id>. <Valor>string</Valor>. </Opcional>. </Opcionales>. </CmpReq>. </ComprobanteConstatar>. </soap:Body>. </soap:Envelope>. donde: Campo Detalle Obligatorio Informaci n de la autenticaci n. Contiene los datos de Auth S. Token, Sign y Cuit Token Token devuelto por el WSAA S. Sign Sign devuelto por el WSAA S. Cuit Cuit contribuyente S. Campo Detalle Obligatorio CmpReq Informaci n del comprobante a constatar. S. CmpReq: La estructura del comprobante de entrada est compuesta por los siguientes campos: Campo Tipo Detalle Obligatorio Modalidad por la cual fue autorizado CbteModo String (4) S.