Diferencias

Muestra las diferencias entre dos versiones de la página.

--- ada:howto:sicoferp:factory:integrations:sicofws [2021/11/19 16:58]
administraidor
+++ ada:howto:sicoferp:factory:integrations:sicofws [2023/04/28 21:31] (actual)
192.168.175.59 [Consideraciones]
@@ Línea 16: / Línea 16: @@
 ^Nombre^Descripción^Tipo Servicio^Tecnología^Lenguaje^Tipo Desarrollo^Versión Desarrollo^Archivo de Configuración^
-|SicofWS|Servicios Web backend para la creación/actualización de terceros, creación facturas y recaudos.|Rest|SpringBoot 1.5.2|Java 1.8|Mantenimiento|8.0.1.0|application.properties|
+|SicofWS|Servicios Web backend para la creación/actualización de terceros, creación facturas y recaudos.|Rest|SpringBoot 1.5.2|Java 1.8|Mantenimiento|8.0.1.2|application.properties|
 ^Tipo Empaquetado^Gestor de Dependencias^Servidor de Despliegue^IDE Proyecto^Tipo Repositorio^Url Desarrollo^Url Calidad^Url Producción^
 |war|Maven 3.8.1|Tomcat 6|SpringTools 4.11|Subversión| |[[http://adacsc.co:1443/svn/repository/ADA/BOTON_PAGOS_AMVA/Trunk/sicofws|SVN trunk]]| |
@@ Línea 82: / Línea 82: @@
 {{ :ada:howto:sicoferp:factory:integrations:despliegue_sicofws.png?600 |}}
-=== Notas de Versión===
+==== Consideraciones ====
+Tener presente que cada vez que se realice un cambio en la base de datos que altere estructuras que son consumidas por el servicio. Este debe reiniciarse para que tome los cambios.
+===== Notas de Versión =====
+==== Actualización 02/09/2021 -> 8.0.1.1 ====
+Se adiciona campo tipo en la factura.
+<code java>
+{
+    "consecutivo":"7",
+    "estado":"A",
+    "descripcion":"prueba 4 ws sicof factura 2 conceptos tipo sa01",
+    "tipo" : "CXCP",//Nuevo Campo
+    "facturas": [
+        {
+        "codigoConcepto" : "AD36" ,
+        "valor" :"100",
+        "nit":"1193474508",
+        "centroCostos":"55301",
+        "fechaPago":"30/09/2021",
+        "descripcion" : "descrip concepto1 ",
+        "seq" : "1",
+        "seqRef" : "1",
+        "referencia": "56563"
+        },
+        {
+        "codigoConcepto" : "AD36" ,
+        "valor" :"200",
+        "nit":"1193474508",
+        "centroCostos":"55301",
+        "fechaPago":"30/09/2021",
+        "descripcion" : "descrip concepto2 ",
+        "seq" : "2",
+        "seqRef" : "1",
+        "referencia": "56563"
+        }
+    ]
+}
+</code>
+==== Actualización 19/11/2021 -> 8.0.1.2 ====
+Se adicionan campos en la creación del tercero para el proceso de factura electrónica.
+<code java>
+[
+  {
+    "nit" : "10262771440",
+    "tipoDocumento": "1",
+    "apellido1": "PALACINO",
+    "apellido2": "VARGAS",
+    "nombre1": "JHON",
+    "nombre2": "ALEXANDER",
+    "direccion": "CLL 54 C SUR  88 I 71 ",
+    "codCiudad": "001",
+    "codDepartamento": "50",
+    "telefono": "3144518117",
+    "email": "jhonpalacino0222@gmail.com",
+    "tipoPersona": "1",
+    "regimen": "N",
+    "tipoVinculo": 29,
+    "codPaisIso":"CO",//Nuevo Campo Código ISO 3611-1
+    "fePostalZone": "500001",//Nuevo Campo Código Postal Colombia
+    "feFiscalResponsability": "R-99-PN"//Nuevo Campo Responsabilidad Fiscal Anexo 1.8
+  }
+]
+</code>
+=== Nuevos Campos ===
+^Http^Path^Nombre^Tipo de Dato^Requerido^Valor por Defecto^Reglas de Validaciones^
+|Post|/tercero/guardarTercero|codPaisIso|String|No|CO|Si el campo es nulo o vacio se asumira el valor "CO". Si el código ISO no existe se cancela el proceso. Se debe enviar un código ISO válido el cual esta descrito en el anexo 1.8 de factura electrónica de la DIAN tabla 13.4.1. Países (ISO 3166‐1): cbc:IdentificationCode Sección Códigos Geográficos|
+|Post|/tercero/guardarTercero|fePostalZone|String|No|Ninguno|Este campo no aplica reglas de validación|
+|Post|/tercero/guardarTercero|feFiscalResponsability|String|No|Ninguno|Si el campo es nulo o vacio se asumira el valor "R-99-PN". Los valores que se pueden enviar estan descritos en el anexo 1.8 de factura electrónica de la DIAN tabla 13.2.6. Responsabilidades fiscales|
+=== Nuevo Código de Errores ===
+Se adicionan los siguientes códigos de errores:
+^Http^Path^Código de Error^Descripción^Solución^
+|Post|/tercero/guardarTercero|1210|Código ISO del país vacío|El Servicio por defecto asumirá el código "CO" para identificar el país Colombia. Se debe enviar un código ISO válido el cual esta descrito en el anexo 1.8 de factura electrónica de la DIAN tabla 13.4.1. Países (ISO 3166‐1): cbc:IdentificationCode Sección Códigos Geográficos|
+|Post|/tercero/guardarTercero|1211|No existe el Código ISO del país|El servicio cancela el proceso. Se debe enviar un código ISO válido el cual esta descrito en el anexo 1.8 de factura electrónica de la DIAN tabla 13.4.1. Países (ISO 3166‐1): cbc:IdentificationCode Sección Códigos Geográficos|
+|Post|/tercero/guardarTercero|1212|Responsabilidad Fiscal vacía|El Servicio por defecto asumirá la responsabilidad "R-99-PN". Los valores que se pueden enviar estan descritos en el anexo 1.8 de factura electrónica de la DIAN tabla 13.2.6. Responsabilidades fiscales|
+==== Actualización 17/07/2022 -> 8.0.1.3 ====
+Se adicionan control de campo requerido celular e inicialización del tipo de operacion con valor por defecto 10 en la creación del tercero para el proceso de factura electrónica.
+<code java>
+[
+  {
+    "nit" : "10262771440",
+    "tipoDocumento": "1",
+    "apellido1": "PALACINO",
+    "apellido2": "VARGAS",
+    "nombre1": "JHON",
+    "nombre2": "ALEXANDER",
+    "direccion": "CLL 54 C SUR  88 I 71 ",
+    "codCiudad": "001",
+    "codDepartamento": "50",
+    "telefono": "3144518117",
+    "celular": "3144518117",
+    "email": "jhonpalacino0222@gmail.com",
+    "tipoPersona": "1",
+    "regimen": "N",
+    "tipoVinculo": 29,
+    "codPaisIso":"CO",//Nuevo Campo Código ISO 3611-1
+    "fePostalZone": "500001",//Nuevo Campo Código Postal Colombia
+    "feFiscalResponsability": "R-99-PN"//Nuevo Campo Responsabilidad Fiscal Anexo 1.8
+    "feOperationType": "10"//Nuevo Campo Tipo operación valor por defecto 10
+  }
+]
+</code>
+=== Actualización Campo ===
+^Http^Path^Nombre^Tipo de Dato^Requerido^Valor por Defecto^Reglas de Validaciones^
+|Post|/tercero/guardarTercero|Celular|String|Si|N/A|Si el campo es nulo o vacio se cancela el proceso y se visualiza mensaje con código de error 1213.|
+=== Nuevo Campo ===
+^Http^Path^Nombre^Tipo de Dato^Requerido^Valor por Defecto^Reglas de Validaciones^
+|Post|/tercero/guardarTercero|feOperationType|String|No|10|Si el campo es nulo o vacio se asumira el valor "10".|
+=== Nuevo Código de Error (17/07/2022) ===
+Se adicionan los siguientes códigos de errores:
+^Http^Path^Código de Error^Descripción^Solución^
+|Post|/tercero/guardarTercero|1213|Celular vacío|El Servicio fallará la creación del tercero si no ingresa infromación en la columna celular.|
+===== Probar Servicio =====
+Se recomienda utilizar la herramienta Postman por su facilidad de uso. Ver guia rápida [[:ada:howto:sicoferp:factory:integrations#Testando Servicio con Postman (Web)|Testando Servicio con Postman (Web)]]
+Agregue un request y registre el servicio segu la imagen
+{{ :ada:howto:sicoferp:factory:integrations:guardartercero001.png?600 |}}
+Si el consumo es correcto se visualiza una respuesta como muestra la imagen
+{{ :ada:howto:sicoferp:factory:integrations:guardartercero002.png?600 |}}
+Si es errrado se visualiza una respuesta como muestra la imagen
+{{ :ada:howto:sicoferp:factory:integrations:guardartercero003.png?600 |}}
 [[ada:howto:sicoferp:factory:integrations|←Volver atrás]]

Wiki

Herramientas de usuario

Herramientas del sitio

Diferencias

Herramientas de la página