Recuerda que:
Ser facturador electrónico conlleva tener la responsabilidad de utilizar de la mejor manera este sistema, este es un proyecto voluntario que beneficia tanto a las empresas como a la ciudadanía.
Temas Técnicos
Estos documentos son detallados en una ficha técnica del proyecto, donde se profundiza más sobre los requerimientos necesarios para facturar de forma electrónica.
Ficha Técnica de Factura Electrónica versión 1.10
Resolución No. 201-5784 del 31 de agosto de 2018
DESCARGAR DOCUMENTONOVEDADES
Bitácora de modificaciones
en la Ficha Técnica*
La clasificación de cada división de la presente bitácora de cambios significa lo siguiente:
Campos y Validaciones: dentro de esta división se encuentra las modificaciones que se realizan a los campos de la factura, las validaciones o a las tablas de la ficha técnica.
Sección de la Ficha Técnica: dentro de esta división se encuentran las modificaciones que se realizan en alguna de las secciones que contiene la ficha técnica.
Campos y Validaciones
ID | Campo/Sección | Detalle |
---|---|---|
JRSch13 | xContenedor de la FE | Se modifica la ocurrencia de 0-100 pasando a ser de 0 -50 |
1519 | Fecha de Emisión muy Antigua | Se modifica la observación de la validación con código 1519, de B10 < 30 días antes de la fecha de transmisión y quedando de la siguiente manera B10 < 8 días antes de la fecha de transmisión. |
ISch06 | gRucDV | Se modifica en el Padre a "ISch05a” ya que el grupo gRucDV es hijo de rRucDV. |
Tabla 28 | Tabla 28 - Codificación Panameña de Bienes y Servicios de Segmetos y Familias | Se modifica la codificación con bienes y servicios de segmentos y familias y se eliminó de la columna con el nombre familia los códigos que tenian los últimos 2 dígitos en 00. |
C302 | dCantGTINCom | Se modifica el tamaño del campo de 1-9p0-6 pasando a ser de 1-11p0-6 |
C304 | dCantComInvent | Se modifica el tamaño del campo de 1-9p0-6 pasando a ser de 1-11p0-6 |
C06 | dCantCodInt | Se modifica el tamaño del campo de 1-9p0-6 pasando a ser de 1-11p0-6 |
formato de fecha | Se modifica el formato de la fecha de TZD pasando a ser TZH la cual aparece en las páginas (50, 52, 54, 56, 58, 59, 61, 64, 67) | |
B07a | Número del documento fiscal duplicado | Se modifica la observación del campo, quedando de la siguiente manera: Ya existe el documento fiscal con los valores de B08, B07, B3012, B303 y B06 informados. |
C202 | dPrUnitDesc | Se modifica el tamaño del campo de 0-11p2 pasando a ser de 1-11p2-6. |
E101 | dNroLote | Se modifica el Tipo del campo de numerico a alfanumerico. |
CD05 | Área de Datos del WS feDescFE | Se modifica el resultado de la validación y se coloca la cantidad de días quedando de la siguiente manera: Rango de fecha de búsqueda excede a 30 días. |
CB06 | Manifestación del Receptor | Se modifica rango de fecha |
A03a | Documento Duplicado | Se modifica el código 1002 y se agrega Tipo de Emisión (B03). |
E101 | dNroLote | Se modifica el Tipo del campo de número a alfanumérico; rango de Tamaño. |
C501 | dTasaISC | Se modifica la ocurrencia de 1-1 pasando a ser 0-1. |
C202 | dPrUnitDesc / validación | Se modifica la observación que decía: aplica solamente si C201 no es vacio y se cambia por: El valor informado debe ser menor que C201 (precio unitario). |
C203 / Jsch15 | dPrItem / validación | Se modifica la observación que decía aplica solamente si C201 y C202 no es vacío. Se crea nuevo criterio es la tabla del Schema XML20, con ID: Jsch15, campo: iTipEv. |
B606f | Validación del CUFE | Se agrega validación nueva con código 1709, Resultado de la validación: CUFE referenciado con duplicado en nota crédto/débito. |
B606g | Validación | Se agrega validación nueva con código 1710, Resultado de la validación: Los documentos electrónicos referenciados no concuerdan con el mismo receptor en la nota de crédito/débito del Ruc receptor distinto del Ruc receptor del CUFE. |
B606h | Validación | Se agrega validación nueva con código 1711, Resultado de la Validación: Monto total de la nota de crédito/débito superior al monto total de la factura referenciada. |
B606i | Validación | Se agrega validación nueva con código 1712, Resultado de la Validación: Nota de crédito que referencia una nota crédito. |
B606j | Validación | Se agrega validación nueva con código 1713, Resultado de la Validación: nota de dédito que referencia una nota dédito. |
B10a | Validación | Se modifica fecha de emisión de un (1) día hábil a dos (2) días hábiles. |
B10C | Validación | Se modifica El Resultado de la validación para que diga de la siguiente forma: Fecha de emisión en el futuro, posterior a 24 horas. |
B401a | Validación | Se agrega Nueva Validación: Resultado de la validación: No fue informado tipo de receptor Extranjero con tipo de documento exportación - Obervación: B06= 03 y B401 <>04. |
B20 | 1532 | Se modifica la validación en observaciones quedando de la siguiente manera: Si la transacción es B2B y iTipoSuc = 1 y dVTot > a B/.200.00. |
B18A | 1533 | Se agrega nueva validación, Resultado de la validación: Informando generación de la FE via web en webservices, observación: B18=4 y se utiliza webservice. |
BA01 | Mensajes de datos de entrada del WS FeRecepFEsuperior a 1000KB | Se modifica el Resultado de la validación y se coloca el tamaño superior máximo a 1000KB. |
F2511, F2512, F2513, F254, F2541 | dTipoRuc | Se corrige el padre de los ID F2511, F2512, F2513 quedando de la siguiente como padre F251, se modifica el padre del ID F254 y se coloca F25, se modifica el padre del ID F2541 y se coloca F254. |
C01 | gItem | Arreglos de formatos para los campos C201, C202, C203, C206, C402, C502 y C602 quedando con 1-9p2-6, y C06,C302 y C304 con 1-9p0-6. |
B10 | dFechaEm | Se modifica la observación de la validación: Ajuste de rango de fecha a 30 días. |
B606g | Validación 1710 | Se agrega la opcion B401= 03 para que se controle cuando se hace una nota de credito, débito a un contribuyente gobierno. |
6.6.5 | Grupo de Total de Otras tasas o Impuestos (OTI) | Inclusión de Grupo de campos (D&0, D601, D602) llamado: Grupo del Total de Otras Tasas o Impuestos (OTI). |
6.5.5 | Código del impuesto o tasa | Inclusión de código del impuesto o tasa 01:SUMA 911 ; 02: Tasa de Portabilidad numerica |
D301 | iFormaPago | Se agrega en la observación del campo una nueva forma de pago: 08: Transf. / Depósito a cta. Bancaria. |
GSch05 | dEvReg | Se agrega en la observación del campo lo siguiente: Schema XML 23: evAnulaFE_v1.00.xsd (Evento de Anulación de FE y Schema XML 22: evManifRecep_v1.00.xsd (Evento de Manifestación del Receptor) |
C10c | Validación 2010 | Se crea nueva validación para controlar que lo que se informe en los campos C10 (dCodCPBScmp) corresponda a lo informado en el campo C09 (dCodCPBSabr) TFS 440 |
B606k | Validación nueva | Se crea validación nueva con ID: B606k , el resultado de la validación es: Fecha de emisión de la nota de crédito/debito supera los 180 día de la fecha de emisión de la FE, el código es: 1714 y la oservación dice lo siguiente: B06=04 o 05 y B10= 180 días > Fecha de FE referenciada. |
B606l | Validación nueva | Se crea validación nueva con ID: B606l, el resultado de la validación es: Nota de crédito que referencia una nota de débito, el código es: 1715 y la oservación dice lo siguiente: B06=04 y B606= CUFE con tipo de documento Nota de Débito. |
B606m | Validación nueva | Se crea validación nueva con ID: B606m , el resultado de la validación es: Nota de débito que referencia una nota de crédito , el código es: 1716 y la oservación dice lo siguiente: B06=05 y B606= CUFE con tipo de documento Nota de Crédito. |
B606n | Validación nueva | Se crea validación nueva con ID: B606n , el resultado de la validación es: Monto de las notas de crédito o débito inconsistentes con el monto de la FE original referenciada, el código es: 1717 y la oservación dice lo siguiente: Monto de la FE referenciada + suma de monto de la ND que la referencia – suma del monto de la NC que la referencia < 0. |
B606o | Validación nueva | Se crea validación nueva con ID: B606o , el resultado de la validación es: No se permite realizar notas de crédito/débito a una FE con un evento de anulación , el código es: 1718 y la oservación dice lo siguiente: B606=04 o 05 y B606=CUFE con evento de anulación *SI el último evento registrado en un documento electrónico es Anulación, no se permite realizar notas de crédito/debito al mismo. |
F102 | dNumAcept | Se modifica la ocupación de 0-1 a 0-50 |
B304 | dCoordEm | Se modifica en la validación B304(dCoordEm) el tamaño de 17 a 22. |
JSch10a | Mensaje de datos de entrada del WS feRecepLoteFE superior a 10000 kB | Se modifica el código de validación en el campo BD01 y en la tabla 18 (Rangos de los Códigos de las Validaciones de los Servicios Web) de 0260 a 0270. |
B402d | Validación Nueva | Se crea validación nueva con ID: B402d, el resultado de la validación es: Informado RUC de contribuyente tipo jurídico existente con tipo de receptor consumidor final, con código de validación 1621 y la observación dice lo siguiente: RUC tipo jurídico en B4022 dRuc con tipo de receptor 02. |
C10a | Validación 2017 | Se agrega en observación la nota "si se informa al menos uno (sea C09 o C10) esta validación no debe aparecer" TFS 440 |
D09C | Validación Nueva | Se crea nueva validación con el siguiente resultado: Valor total de la factura elevada en venta a consumidor final, Observación: B401 = 02 y D09 > 10 mil dólares. |
B18A | Informado generación de la FE vía web en webservice | Se modifica el nombre del ID B18A por B18a y el número del código de 1533 a 1536. |
BD01 | Mensaje de datos de entrada del WS feRecepLoteFE superior a 10000 kB | Se modifica el código de validación en el campo BD01 y en la tabla 18 (Rangos de los Códigos de las Validaciones de los Servicios Web) de 0260 a 0270. |
B3011 | dTipoRuc | Se coloca los tipos de contribuyente en el comentario, quedando de la siguiente manera: Tipo de contribuyente 1: Natural, 2: Juridico. |
B601a | Validación nueva | Se crea validación nueva con ID: B601a, el resultado de la validación es: Datos informados en grupo de campos de documento referenciado no concuerda con los datos del emisor, con código de validación 1719 y la observación dice lo siguiente: B6011<> B3011, B6012<> B3012, B6013<> B3013 *En el mensaje de respuesta se especificará en que campo está el error (dTipoRuc, dRuc o dDv). |
B603b | Validación nueva | Se crea validación nueva con ID: B603b, el resultado de la validación es: Fecha informada en el campo dFechaDFRef no concuerda con la fecha en la que se emitió la factura referenciada, el código es: 1720 y la observación dice lo siguiente: B603 <> Fecha de FE referenciada en campo B606 |
C601 | dCodOTI | Se agrega en la observación del campo una nueva tasa: 03: Impuesto sobre seguro |
D601 | dCodOTITotal | Se agrega en la observación del campo una nueva tasa: 03: Impuesto sobre seguro |
D601 | El código de otras tasas o impuestos a nivel de ítems, difiere del código de otras tasas o impuestos a nivel del grupo de totales | Se añade en la observación lo siguiente: Existe C601=01 o C601=02 o C601=03 y no existe D601=01 o D601=02 o D601=03 |
F103 | dCodReC | Se crea nuevo campo opcional "Código de cliente/receptor", en la sección 6.8.1.; Alfanumérico de 1-50 caracteres. Permite registrar el código con que el facturador identifica a su cliente o receptor de la factura. |
F104 | dCodSisEm | Se crea nuevo campo opcional "Código de sistema emisor", en la sección 6.8.1.; Alfanumérico de 1-50 caracteres. Permite registrar el código del sistema que emite la factura electrónica (de utilidad cuando un emisor disponga de más de un sistema de |
D04a | Validación 2516 | Se crea validación nueva con ID: D04a, el resultado de la validación es: El campo dTotISC es requerido porque informo el campo dValISC, con código de validación 2516 y la observación dice lo siguiente: Existe C502 y no fue informado D04. |
D04b | Validación 2517 | Se crea validación nueva con ID: D04b, el resultado de la validación es: El campo dValISC es requerido porque informo el campo dTotISC, con código de validación 2517 y la observación dice lo siguiente: Existe D04 y no fue informado C502. |
F101 | Número del pedido de compra (dNroPed) | Se modifica el tipo de dato, pasa de numérico a alfanumérico. |
B10 | Fecha de emisión muy antigua | Se modifica el tipo de efecto en el campo B10, pasa de "rechazo" a "notificación". |
JSch10b | iTipoRec | se agrega un campo dentro de la tabla que describe el nuevo criterio de búsqueda por receptor |
AA08 | Tipo de contribuyente no concuerda con el Ruc del certificado del transmisor | Validaciones por cambio de certificado |
AA09 | Dígito verificador no concuerda con el Ruc del certificado del transmisor | Validaciones por cambio de certificado |
AA10 | Tipo de destino del certificado del transmisor inválido | Validaciones por cambio de certificado |
AA11 | No existe la extensión del DV en el certificado del transmisor | Validaciones por cambio de certificado |
AA12 | No existe la extensión del tipo de contribuyente en el certificado del transmisor | Validaciones por cambio de certificado |
AC08 | Tipo de contribuyente no concuerda con el Ruc del certificado utilizado en la firma. | Validaciones por cambio de certificado |
Sección de la Ficha Técnica
ID | Campo/Sección | Detalle |
---|---|---|
4 | Aspectos Tecnológicos de los servicios web | Se incluyen WS dentro del sistema los cuales son: Consulta de facturas por criterios, Consulta de Ruc y DV (individual), Consulta de Ruc y DV (lote). |
3.1 | Modelo Conceptual de la Comunicación | Se incluyen WS dentro del sistema los cuales son: Consulta de facturas por criterios, Consulta de Ruc y DV (individual), Consulta de Ruc y DV (lote). |
9.4.1 | Código QR para el modelo de autorización Previa y posterior | Se modifica la dirección de URLBase: https://dgi-fepst.mef.gob.pa/Consultas/FacturasPorQR? (pruebas) https://dgi-fep.mef.gob.pa/Consultas/FacturasPorQR? (producción) |
3.6 | Estandar de Firma Digital | Se modifica la primera línea del ejemplo de la firma que aparece en la página #39. |
7.3 | Manifestación del Receptor | Se modifica la cantidad de días en el registro de evento de una FE en la siguiente línea: Emitida más de 30 días antes del registro del evento; se cambia por: Emitida más de 8 días antes del registro del evento. |
7.3.3 | Descripción del Procesamiento | Se modifica la cantidad de días de 30 a 8 días en el Párrafo que dice lo siguiente: Cuya fecha de emisión sea anterior a 8 días, contados desde el momento de la recepción del registro del evento de anulación de FE. |
5.8.1 | Definición del Mensaje de Entrada / Schema XML 19 | Se incluyen campo dentro de la tabla del Schema XML 19 con ID - ISch05a, nombre de campo - rRucDV. |
7 | Los Eventos de la FE | Se modifica la Secciones de los Eventos: FE Anulada de 7.1 a 7.2 y Anulación de Manisfetación del Receptor de 7.4 a 7.3. |
5.8.3 | Definición del Mensaje de Respuesta / Schema XML 20 | Se incluyen campo con ID IRSch07a, nombre del campo - rResRucDV dentro del WS feConsLoteRucDV |
5.8.3 | Definición del Mensaje de Respuesta / Schema XML 20 | Se modifica el padre del campo gResRucDV y queda de la siguiente manera: IRSch07a. |
5.8.2 | Descripción del Procesamiento | Se agrega validación nueva en la tabla 12 con el nombre de condición: Tipo de contribuyente inválido, con código 0725. |
8.3.8.3 | Área de Datos del WS feConsLoteRucDV | Se agrega validación nueva en la tabla 8.3.8.3, ID-CA06, Resultado de la validación: Tipo de contribuyente inválido, código 0725. |
6.1.3 | Tratamiento de caracteres especiales en el texto XML | Se agrega sección nueva con el listado de caracteres especiales que afectan el texto XML. |
10.3.1 | Codificación Panameña de Bienes y Servicios | Se realizó ajuste en la sección 10.3.1. donde se expresa que cuando el receptor es gobienro, es obligatorio informar el campo C10 y opcional el C09. |
8.5 | Validaciones de los Eventos de la FE | Se modifican los códigos de la sección 8.5.1. Anulación de FE y la sección 8.5.2 Manifestación de receptor, agregandoles un cero adelante a todos los códigos, ejemplo: de 620 a 0620. |
5 | Descripción de los Servicios Web | Se realizó una corrección de la palabra "descripto" y se reemplazo por la palabra "descrito" en el primer párrafo del apartado 5. Descripción de los Servicios Web. |
7.2 | Anulación de FE | Anulación de FE |
8.3.1 | WS Recepción FE – FeRecepFE | Se modifica una oración en el párrafo de mensaje, quedando de la siguiente manera: "En el caso que la DIRECCIÓN GENERAL DE INGRESOS implemente el control de tamaño de mensaje" |
8.3.2 | WS Recepción FE Lote – feRecepLoteFE | Se modifica una oración en el párrafo de mensaje, quedando de la siguiente manera: "En el caso que la DIRECCIÓN GENERAL DE INGRESOS implemente el control de tamaño de mensaje" |
8.3.3 | WS Consulta Resultado Lote – feResultLoteFE | Se modifica una oración en el párrafo de mensaje, quedando de la siguiente manera: "En el caso que la DIRECCIÓN GENERAL DE INGRESOS implemente el control de tamaño de mensaje" |
8.3.4 | WS Consulta FE – feConsFE | Se modifica una oración en el párrafo de mensaje, quedando de la siguiente manera: "En el caso que la DIRECCIÓN GENERAL DE INGRESOS implemente el control de tamaño de mensaje" |
8.3.5 | WS Consulta FE Destinadas – feConsFEDest | Se modifica una oración en el párrafo de mensaje, quedando de la siguiente manera: "En el caso que la DIRECCIÓN GENERAL DE INGRESOS implemente el control de tamaño de mensaje" |
8.3.6 | WS Recepción Evento – feRecepEvento | Se modifica una oración en el párrafo de mensaje, quedando de la siguiente manera: "En el caso que la DIRECCIÓN GENERAL DE INGRESOS implemente el control de tamaño de mensaje" |
8.3.7 | WS Consulta de RUC y DV (individual)– feConsRucDV | Se modifica una oración en el párrafo de mensaje, quedando de la siguiente manera: "En el caso que la DIRECCIÓN GENERAL DE INGRESOS implemente el control de tamaño de mensaje" |
8.3.8 | WS Consulta de RUC y DV (individual)– feConsRucDV | Se modifica una oración en el párrafo de mensaje, quedando de la siguiente manera: "En el caso que la DIRECCIÓN GENERAL DE INGRESOS implemente el control de tamaño de mensaje" |
8.3.9 | WS de descarga de Facturas por criterios– feDescFE | Se modifica una oración en el párrafo de mensaje, quedando de la siguiente manera: "En el caso que la DIRECCIÓN GENERAL DE INGRESOS implemente el control de tamaño de mensaje" |
8.3.2.3 | WS de descarga de Facturas por criterios– feDescFE | WS de descarga de Facturas por criterios– feDescFE |
10.3.2 | Catálogo de Unidades de Medida | Se agrega al catálogo las siguiente medida: Millar (unidad de cuenta que define el número de unidades contadas en múltiplos de 1000). |
6.1.1 | Estructura del CUFE | En la descripción del ejemplo del punto 6.1.1 Estructura del CUFE, en "Ambiente de Autorización" se corrige por "Ambiente de destino" |
3.6 | Estándar de Firma Digital | se agregó ejemplo con certificado exclusivo de factura electrónica (nuevo) |
AC09 | Dígito verificador no concuerda con el Ruc del certificado utilizado en la firma | Validaciones por cambio de certificado |
AC10 | Tipo de destino de certificado de firma inválido | Validaciones por cambio de certificado |
AC11 | No existe la extensión del DV en el certificado de firma | Validaciones por cambio de certificado |
AC12 | No existe la extensión del tipo de contribuyente en el certificado de firma | Validaciones por cambio de certificado |
*Los ajustes mencionados en La Bitácora de Modificaciones son aplicados al ambiente productivo del Sistema de Facturación Electrónica de Panamá (SFEP).
Descargar Versión de la Ficha Técnica de Factura Electrónica con los ajustes mencionados en La Bitácora de Modificaciones.
Esquemas de XML y Servicios Web (XSD) Descargar
Direcciones URL de Servicios Web de Prueba y Producción
Recuerda que los servicios web sólo lo pueden utilizar los contribuyentes que cuenten con el certificado de firma electrónica (emitida por la Dirección de firma electrónica del Registro Público de Panamá) y se encuentren afiliados a cualquiera de los ambientes (Pruebas o Producción).
PRUEBA (TEST)
WS Disponibles:
- WS Recepción FE (Factura Individual)
https://dgi-fepws-test.mef.gob.pa:40010/FepWcfService/feRecepFE.svc - WS Recepción FE Lote (Factura Lote)
https://dgi-fepws-test.mef.gob.pa:40010/FepWcfService/feRecepLoteFE.svc - WS Consulta Resultado de Lote – Consulta de Lote
https://dgi-fepws-test.mef.gob.pa:40010/FepWcfService/feResultLoteFE.svc - WS Recepción de Evento (Anulación y Manifestación)
https://dgi-fepws-test.mef.gob.pa:40010/FepWcfService/feRecepEvento.svc - WS Consulta FE
https://dgi-fepws-test.mef.gob.pa:40010/FepWcfService/feConsFE.svc - WS Consulta de RUC y DV (Individual)
https://dgi-fepws-test.mef.gob.pa:40010/FepWcfService/feConsRucDV.svc - WS Consulta de RUC y DV (Lote)
https://dgi-fepws-test.mef.gob.pa:40010/FepWcfService/feConsLoteRucDV.svc - WS de descarga de Facturas por criterios
https://dgi-fepws-test.mef.gob.pa:40010/FepWcfService/feDescFE.svc
PRODUCCIÓN
WS Disponibles:
- WS Recepción FE (Factura Individual)
https://dgi-fepws.mef.gob.pa:40100/FepWcfService/feRecepFE.svc - WS Recepción FE Lote (Factura Lote)
https://dgi-fepws.mef.gob.pa:40100/FepWcfService/feRecepLoteFE.svc - WS Consulta Resultado de Lote – Consulta de Lote
https://dgi-fepws.mef.gob.pa:40100/FepWcfService/feResultLoteFE.svc - WS Recepción de Evento (Anulación y Manifestación)
https://dgi-fepws.mef.gob.pa:40100/FepWcfService/feRecepEvento.svc - WS Consulta FE
https://dgi-fepws.mef.gob.pa:40100/FepWcfService/feConsFE.svc - WS Consulta de RUC y DV (Individual)
https://dgi-fepws.mef.gob.pa:40100/FepWcfService/feConsRucDV.svc - WS Consulta de RUC y DV (Lote)
https://dgi-fepws.mef.gob.pa:40100/FepWcfService/feConsLoteRucDV.svc - WS de descarga de Facturas por criterios
https://dgi-fepws.mef.gob.pa:40100/FepWcfService/feDescFE.svc