Timbrado

Web Services
Timbrado

SF:ERP Web Services

Timbrado

Descripcin
Este documento describe el Web Service CF01, !ue contiene los m)todos 2ara el timbrado 3 cancelacin de CF01 2or S45P

Web Service UR de pruebas !stilo de WSD

Timbrado http://184.106.171.214:8080/ws/services/Timbrado?wsdl 0ocument

"redenciales
El nombre de usuario 3 contrase6a a utili7ar en los m)todos son los asi8nados desde el 2anel de administracin de timbrado del cliente" 9as credenciales de 2rueba !ue 2ueden usarse 2ara 2ruebas son las si8uientes: Usuario: testin8:solucion;actible"com "ontrase#a: timbrado"SF".--<2

$%todos
9a lista de m)todos de este Web Service se listan a continuacin timbrar" Recibe 3 timbra uno o varios CF01 cancelar" Recibe el ;olio ;iscal +==10, de uno o varios CF01 3 los cancela

Descripcin detallada de los m%todos

$%todo certificar
Recibe un CF01, lo valida 3, en caso de !ue 2ase todas las validaciones, se timbra, devolviendo el CF01 con el com2lemento de Timbre Fiscal 0i8ital" &ar'metros Este m)todo recibe cuatro 2ar>metros Par>metros del m)todo timbrar (ombre Tipo Uso Descripcin usuario Strin8 ( Nombre de usuario re8istrado 2ara el uso del WebService 2ass?ord Strin8 ( Contrase6a del usuario c;di 5rra3 de b3tes ( 5rre8lo de b3tes +binario, del CF01 en ;ormato @(9 o 7i2 con uno o varios CF01 7i2 Aoolean 4 Aooleano !ue indica si los datos enviados corres2onden a un arcBivo "7i2

SF:ERP Web Services

Timbrado

Retorno Este m)todo retorna un ti2o com2uesto: CF01Certi;icacion, los atributos se describen en la si8uiente tabla 5tributos de CF01Certi;icacion (ombre Tipo Uso Descripcin status int ( El cdi8o status de la o2eracin, el detalle de cdi8os de res2uesta se detalla en el ane*o CCdi8os de res2uesta de timbradoD mensa'e Strin8 ( El mensa'e de res2uesta, una candena de caracteres detallando el status de la o2eracin" resultados 5rra3 de 4 =n arra3 de CF01ResultadoCerti;icacion, un ti2o com2uesto cu3os CF01Resultado atributos se detallan en la tabla C5tributos de CF01ResultadoCerti;icacionD Certi;icacion En la si8uiente tabla se detallan los atributos del ti2o CF01ResultadoCerti;icacion 5tributos de CF01ResultadoCerti;icacion (ombre Tipo Uso Descripcin status int ( Status del resultado de validacin 3 timbrado del CF01, 2ara detalles de los cdi8os de status de certi;icacin consulte CCdi8os de res2uesta de validacin de CF01D mensa'e Strin8 ( (ensa'e detallado de la o2eracin reali7ada o descri2cin del error uuid Strin8 C Folio ;iscal del CF01 !ue se timbr versionTF0 Strin8 C Eersin del com2lemento de Timbre Fiscal 0i8ital ;ecBaTimbrado 0ateTime C FecBa de timbrado del CF01 selloS5T Strin8 C Sello del S5T, el sello del Timbre Fiscal 0i8ital certi;icadoS5T Strin8 C NFmero de serie del certi;icado del S5T em2leado 2ara timbrar el CF01 cadena4ri8inal Strin8 C Cadena ori8inal del Timbre Fiscal 0i8ital o Com2lemento de Certi;icacins c;diTimbrado 5rra3 de b3tes C CF01 con el Timbre Fiscal 0i8ital !rCode 5rra3 de b3tes C Cdi8o bidimensional GRCode del CF01, son los datos binarios de una ima8en en ;ormato 2n8

$%todo cancelar
Cancela uno o varios CF01 &ar'metros Este m)todo recibe seis 2ar>metros Par>metros del m)todo timbrar (ombre Tipo Uso Descripcin usuario Strin8 ( Nombre de usuario re8istrado 2ara el uso del WebService 2ass?ord Strin8 ( Contrase6a del usuario uuids 5rra3 de Strin8 ( 5rre8lo de Strin8s con los ;olios ;iscales +==10s, de los CF01 a certi;icar derCertCS0 5rra3 de b3tes ( CS0 a utili7ar 2ara la encri2cin de la solicitud de cancelacin, debe ser el mismo con el !ue se 8ener el sello di8ital del CF01 derHe3CS0 5rra3 de b3tes ( 9lave 2rivada del CS0, debe ser la misma con la se 8ener el sello di8ital

SF:ERP Web Services

contrasenaCS0 Strin8

Timbrado
del CF01 ( Contrase6a de la llave 2rivada del CS0 con el !ue se 8ener el sello di8ital del CF01

Retorno Este m)todo retorna un ti2o com2uesto: CF01Cancelacion, los atributos se describen en la si8uiente tabla 5tributos de CF01Cancelacion (ombre Tipo Uso Descripcin status int ( El cdi8o status de la o2eracin, el detalle de cdi8os de res2uesta se detalla en el ane*o CCdi8os de res2uesta de cancelacinD mensa'e Strin8 ( El mensa'e de res2uesta, una candena de caracteres detallando el status de la o2eracin" resultados 5rra3 de 4 =n arra3 de CF01ResultadoCancelacion, un ti2o com2uesto cu3os CF01Resultado atributos se detallan en la tabla C5tributos de CF01ResultadoCerti;icacionD Cancelacion En la si8uiente tabla se describen los atributos de CF01ResultadoCancelacion 5tributos de CF01ResultadoCancelacion (ombre Tipo Uso Descripcin status int ( Status del resultado de la cancelacin del CF01, 2ara detalles de los cdi8os de status de cancelacin consulte CCdi8os de status de cancelacin de CF01D uuid Strin8 ( (ensa'e detallado de la o2eracin reali7ada o descri2cin del error mensa'e Strin8 ( Folio ;iscal del CF01 !ue se timbr status==10 Strin8 C Status de res2uesta del S5T 2ara el com2robante !ue se envi a cancelacin, 2ara detalles de los cdi8os de status de cancelacin consulte CCdi8os de res2uesta del S5T 2ara la cancelacin de CF01D

SF:ERP Web Services

Timbrado

)ne*os
"di+os de respuesta de timbrado
"di+o 2%% $%% Descripcin El 2roceso de validacin se Ba com2letado correctamente Ian ocurrido errores !ue no Ban 2ermitido com2letar el 2roceso de validacin/certi;icacin

"di+os de respuesta de validacin de ",D"di+o 2%% 3%. 3%2 3%3 3%# 3%$ 3%3%< 3%8 #%. #%2 #%3 Descripcin CF01 correctamente validado 3 timbrado El CF01 no tiene una estructura @(9 correcta El sello del emisor no es v>lido El Certi;icado de Sello 0i8ital no corres2onde al contribu3ente emisor El certi;icado se encuentra revocado o caduco 9a ;ecBa del CF01 est> ;uera del ran8o de la valide7 del certi;icado El certi;icado usado 2ara 8enerar el sello di8ital no es un Certi;icado de Sello 0i8ital El CF01 3a Ba Ba sido timbrado 2reviamente El certi;icado utili7ado 2ara 8enerar el sello di8ital no Ba sido emitido 2or el S5T 9a ;ecBa del com2robante est> ;uera del ran8o de timbrado 2ermitido El contribu3ente no se encuentra dentro del r)8imen ;iscal 2ara emitir CF01 9a ;ecBa de emisin del CF01 no 2uede ser anterior al . de enero de 2%..

"di+os de respuesta de cancelacin

"di+o 2%% $%% Descripcin El 2roceso de cancelacin se Ba com2letado correctamente Ian ocurrido errores !ue no Ban 2ermitido com2letar el 2roceso de cancelacin

"di+os de status de cancelacin de ",D"di+o 2%% $%% Descripcin El 2roceso de cancelacin se Ba com2letado correctamente Ian ocurrido errores !ue no Ban 2ermitido com2letar el 2roceso de cancelacin

"di+os de respuesta del S)T para la cancelacin de ",D"di+o 2%. 2%2 2%3 2%# 2%$ Descripcin El ;olio se Ba cancelado con )*ito El ;olio 3a se BabJa cancelado 2reviamente El com2robante !ue intenta cancelar no corres2onde al contribu3ente con el !ue se Ba ;irmado la solicitud de cancelacin El CF01 no a2lica 2ara cancelacin No se encuentra el ;olio del CF01 2ara su cancelacin