meta data de esta página
Método Enviar
La función encargada de construir y enviar el documento electrónico
Ver Catálogos de códigos de retorno del servicio
REQUEST: Parámetros a Enviar | ||
---|---|---|
Tipo | Identificador | Descripcion |
String | TokenEmpresa/TokenPassword | Suministrado por el proveedor tecnologico |
Objeto | DocumentoElectronico | Ver detalle abajo |
Documento Electrónico | ||||
---|---|---|---|---|
Tipo | Requerido | Formato | Identificador | Descripción |
String | SI | AN|4 | codigoSucursalEmisor | 0000: Casa matriz 0001 en delante: Otras sucursales. Puede utilizar números y letras. |
DatosFactura | ||||
---|---|---|---|---|
Tipo | Requerido | Formato | Identificador | Descripción |
String | SI | N|2 | tipoEmision | 01: Autorización de Uso Previa, operación normal. 02: Autorización de Uso Previa, operación en contingencia. 03: Autorización de Uso Posterior, operación normal. 04: Autorización de Uso posterior, operación en contingencia. |
String | C/C | AN|25 | fechaInicioContingencia | AAAA-MM-DD hh:mm:ssTZH Obligatorio si, tipoEmision = 02 / 04 |
String | C/C | AN|15..250 | motivoContingencia | Obligatorio si tipoEmision=02 / 04 Si la contingencia dura más de 72 horas también debe explicar las razones para no haber regresado a la operación normal. |
String | SI | N|2 | tipoDocumento | 01: Factura de operación interna 02: Factura de importación 03: Factura de exportación 04: Nota de Crédito referente a una FE 05: Nota de Débito referente a una FE 06: Nota de Crédito genérica 07: Nota de Débito genérica 08: Factura de Zona Franca 09: Reembolso 10: Factura de operación extranjera |
String | SI | N|10 | numeroDocumentoFiscal | Número del documento fiscal en la serie correspondiente, de 0000000001 a 9999999999, no siendo permitido el reinicio de la numeración. Llenar con ceros las posiciones a la izquierda. |
String | SI | N|3 | puntoFacturacionFiscal | Punto de Facturación del documento fiscal. La serie sirve para permitir que existan secuencias independientes de numeración de facturas. No se admite el valor “cero”. Llenar con ceros las posiciones a la izquierda. |
String | SI | AN|25 | fechaEmision | AAAA-MM-DDThh:mm:ssTZH |
String | NO | N|25 | fechaSalida | AAAA-MM-DDThh:mm:ssTZH Informar cuando sea conocida. |
String | SI | N|2 | naturalezaOperacion | 01: Venta. 02: Exportación. 03: Re-exportación 04: venta de fuente extranjera 10: Transferencia/Traspaso. 11: Devolución. 12: Consignación. 13: Remesa. 14: Entrega gratuita. 20: Compra. 21: Importación. |
String | SI | N|1 | tipoOperacion | 1: Salida o venta. 2: Entrada o compra (factura de compra- para comercio informal. Ej.: taxista, trabajadores manuales). |
String | SI | N|1 | destinoOperacion | 1: Panamá. 2: Extranjero. |
String | SI | N|1 | formatoCAFE | 1: Sin generación de CAFE: El emisor podrá decidir generar CAFE en cualquier momento posterior a la autorización de uso de FE. 2: Cinta de papel. 3: Papel formato carta. |
String | SI | N|1 | entregaCAFE | 1: Sin generación de CAFE: El emisor podrá decidir generar CAFE en cualquier momento posterior a la autorización de uso de FE. 2: CAFE entregado para el receptor en papel. 3: CAFE enviado para el receptor en formato electrónico. |
String | SI | N|1 | envioContenedor | 1: Normal. 2: El receptor exceptúa al emisor de la obligatoriedad de envío del contenedor. El emisor podrá decidir entregar el contenedor, por cualquier razón, en momento posterior a la autorización de uso, pero no era esta su intención en el momento de la emisión de la FE. |
String | SI | N|1 | procesoGeneracion | 1: Generación por el sistema de facturación del contribuyente (desarrollo propio o producto adquirido). |
String | SI | N|1 | tipoVenta | Tipo de Venta para el vendedor: 1: Venta de Giro del negocio. 2: Venta Activo Fijo. 3: Venta de Bienes Raíces. 4: Prestación de Servicio. Si no es venta, no informar este campo. |
String | NO | N|1 | tipoSucursal | 1: Mayor cantidad de Operaciones venta al detal (retail) 2: Mayor cantidad de Operaciones venta al por mayor Si la transacción es B2B y tipoSucursal = 01 y dvtot. |
String | NO | AN|...5000 | informacionInteres | Información del interés del emisor con respecto a la FE. |
Cliente | ||||
---|---|---|---|---|
Tipo | Requerido | Formato | Identificador | Descripción |
String | SI | N|2 | tipoClienteFE | Identifica el tipo de receptor de la FE. 01:Contribuyente. 02:Consumidor final. 03:Gobierno. 04:Extranjero. |
String | SI | N|1 | tipoContribuyente | Tipo de Contribuyente: 1:Natural. 2:Jurídico. No informar si tipoClienteFE = 04 |
String | C/C | AN|20 | numeroRUC | RUC del Receptor. Si utiliza 02:Consumidor Final este campo puede llenarlo con la cédula de identificación del ciudadano si este lo solicita. No debe ser enviado cuando tipoClienteFE = 04 |
String | C/C | N|2 | digitoVerificadorRUC | Debe ser calculado en base al algoritmo del RUC publicado por la DGI. Es obligatorio y debe ser válido si tipoClienteFE = 01/03 (comprador contribuyente del ITBMS). No debe ser enviado cuando tipoClienteFE = 04 |
String | C/C | AN|2..150 | razonSocial | Obligatorio si TipoClienteFE = 01/03 (comprador contribuyente del ITBMS). |
String | C/C | AN|5..100 | direccion | Urbanización, Calle, Casa/Edificio, Número de Local. Obligatorio si TipoClienteFE = 01/03 (comprador contribuyente del ITBMS). |
String | C/C | AN|..8 | codigoUbicacion | Obligatorio si TipoClienteFE = 01/03. Código compuesto de la ubicación. No debe ser enviado cuando tipoClienteFE = 04 |
String | C/C | AN|..50 | provincia | Obligatorio si TipoClienteFE = 01/03 (comprador contribuyente del ITBMS). Según Catálogo unificado de Provincias, Distritos y Corregimientos. No debe ser enviado cuando tipoClienteFE = 04 |
String | C/C | AN|..50 | distrito | Obligatorio si TipoClienteFE = 01/03 (Comprador contribuyente del ITBMS). Según Catálogo unificado de Provincias, Distritos y Corregimientos. No debe ser enviado cuando tipoClienteFE = 04 |
String | C/C | AN|..50 | corregimiento | Obligatorio si TipoClienteFE = 01/03 (Comprador contribuyente del ITBMS). Según Catálogo unificado de Provincias, Distritos y Corregimientos. No debe ser enviado cuando tipoClienteFE = 04 |
String | C/C | N|2 | tipoIdentificacion | Es Obligatorio sí tipoClienteFE = 04:Extranjero. 01:Pasaporte 02:Numero Tributario 99:Otro |
String | C/C | AN|..50 | nroIdentificacionExtranjero | Número de Pasaporte o Número de Identificación Tributaria Extranjera. Es Obligatorio sí tipoClienteFE=04: Extranjero |
String | C/C | AN|..50 | paisExtranjero | Solo se utiliza si se llena nroIdentificacionExtranjero con pasaporte. Utilizar nombre completo del país. |
String | NO | AN|7..12 | telefono1 | Teléfono de contacto del receptor de la FE. Formatos aceptables: 999-9999 ó 9999-9999 |
String | NO | AN|..50 | correoElectronico1 | Correo electrónico del receptor. Correo valido. |
String | NO | AN|..50 | correoElectronico2 | Correo electrónico del receptor. Correo valido. |
String | NO | AN|..50 | correoElectronico3 | Correo electrónico del receptor. Correo valido. |
String | SI | AN|2 | pais | De acuerdo con los códigos del Catálogo unificado de Provincias, Distritos y Corregimientos • Debe ser PA (Panamá) si destinoOperacion = 1 (Panamá). • No puede PA (Panamá) si destinoOperacion = 2 (otro país)". Debe ser ZZ si el pais no existe dentro del catálogo. |
String | C/C | AN|5..50 | paisOtro | Obligatorio si pais = ZZ, debe ser el nombre completo del pais. |
datosFacturaExportacion (Existe si el destino de operación es distinto a Panamá) | ||||
---|---|---|---|---|
Tipo | Requerido | Formato | Identificador | Descripción |
String | SI | AN|3 | condicionesEntrega | Condiciones de entrega de acuerdo con la Tabla 1.INCOTERMS. |
String | SI | AN|3 | monedaOperExportacion | Código de moneda usada para exportación, de acuerdo a la Tabla 2. Norma ISO 4217. |
String | C/C | AN|5..50 | monedaOperExportacionNonDef | Obligatorio si MonedaOperExportacion = ZZZ Para monedas no definidas en la Tabla 2. Norma ISO 4217. |
String | C/C | N|1..11|2.4 | tipoDeCambio | Para monedas diferentes al USD. Obligatorio si existe MonedaOperExportacion. |
String | C/C | N|1..20|0.4 | montoMonedaExtranjera | Para monedas diferentes al USD. Obligatorio si existe MonedaOperExportacion. Debe corresponder al producto de tipoDeCambio por totalFactura. |
String | NO | AN|5..50 | puertoEmbarque | Puerto de Embarque de la mercancía. |
List<docFiscalReferenciado> (Opcional)) | ||||
---|---|---|---|---|
Tipo | Requerido | Formato | Identificador | Descripción |
String | SI | AN|25 | fechaEmisionDocFiscalReferenciado | Fecha de emisión del Documento Fiscal Referenciado |
String | SI | AN|66 | cufeFEReferenciada | CUFE de FE referenciada. Deben ser las 66 posiciones que conforman el CUFE. |
String | NO | AN|22 | nroFacturaPapel | Hace referencia al número de la factura en papel. No se debe informar si existe cufeFEReferenciada. |
String | NO | AN|22 | nroFacturaIF | Número de factura emitida por impresora fiscal. No se debe informar si existe cufeFEReferenciada. |
List<autorizadoDescargaFEyEventos> | ||||
---|---|---|---|---|
Tipo | Requerido | Formato | Identificador | Descripción |
String | SI | N|1 | tipoContribuyente | Tipo de Contribuyente: 1:Natural. 2:Jurídico |
String | SI | AN|20 | rucReceptor | RUC autorizado a descargar la FE. Ejemplo: Caso: La empresa desea darle acceso a su firma de contadores o a un tercero. |
String | SI | N|1 | digitoVerifRucReceptor | Debe ser calculado en base al algoritmo del RUC publicado por la DGI. |
List<Item> | ||||
---|---|---|---|---|
Tipo | Requerido | Formato | Identificador | Descripción |
String | SI | AN|2..500 | descripción | Descripción del producto o servicio. |
String | NO | AN|1..20 | Código | Código del producto o servicio en el catálogo del emisor. |
String | NO | AN|1..20 | unidadMedida | Debe corresponder al catálogo de unidades de medida dispuesta en la Tabla 3. |
String | SI | N|1..9|2.6 | cantidad | Cantidad del producto o servicio, en la unidad de medida del código interno. Expresado en la unidad de medida del código interno |
String | C/C | AN|10 | fechaFabricacion | Formato AAAA-MM-DD Obligatorio si el ítem es: Materia prima farmacéutica, medicina, alimento. |
String | C/C | AN|10 | fechaCaducidad | Formato AAAA-MM-DD. |
String | NO | AN|2 | codigoCPBSAbrev | Debe corresponder a la tabla de la Codificación Panameña de Bienes y Servicios de Segmentos y Familias en Tabla 4. No informar este campo si el bien o servicio no puede ser clasificado en ninguna de las opciones de esta Tabla. Obligatorio solo cuando tipoCliente = 03. |
String | C/C | AN|4 | codigoCPBS | Debe corresponder a la tabla de la Codificación Panameña de Bienes y Servicios en Tabla 4. Campo obligatorio si es venta a la Administración Pública. Obligatorio solo cuando tipoCliente = 03. |
String | NO | AN|1..30 | unidadMedidaCPBS | Debe corresponder al catálogo de unidades de medida en Tabla 3. Obligatorio solo cuando tipoCliente = 03. |
String | NO | AB|0..5000 | infoItem | Información de interés del emisor con respeto a un ítem de la FE. |
String | SI | N|0..11|2.6 | precioUnitario | Precio unitario de la transferencia del bien o servicio. Si el ítem no es valorable: informar campo en 0.00 |
String | SI | N|1..9|2.6 | precioUnitarioDescuento | Informar valor del descuento en Balboas, no en porcentaje. Si el ítem no es valorable: No informar en el campo. El valor informado debe ser menor que precio unitario. |
String | SI | N|1..9|2..6 | precioItem | Precio del ítem. Si el ítem no es valorable: informar campo en 0.00 PrecioItem <> Cantidad * (PrecioUnitario - PrecioUnitarioDescuento) |
String | NO | N|1..9|2 | precioAcarreo | Precio del acarreo, para este ítem específico. Si se informa, no se puede informar (Valor del acarreo cobrado en el precio total). |
String | NO | N|1..9|2 | precioSeguro | Precio del seguro, para este ítem específico. Si se informa, no se puede informar (Valor del seguro cobrado en el precio total). |
String | SI | N|1..9|2.6 | valorTotal | Suma del precio del ítem con los montos de los impuestos. Si el ítem no es valorable: informar campo en 0.00 En caso contrario: informar la suma de PrecioItem, PrecioAcarreo, PrecioSeguro, ValorITBMS y ValorISC. |
String | NO | N|..14 | codigoGTIN | Código GTIN del ítem, para la unidad de comercialización. Antiguos códigos EAN, UPC y DUN-14. Informar campo vacío si el producto no posee este código. Campos opcionales, si se declara al menos 1 correspondiente a GTIN se deben declarar todos. |
String | NO | N|1..9|0.6 | cantGTINCom | Cantidad del producto o servicio en el Código GTIN del ítem de comercialización. |
String | NO | N|..14 | codigoGTINInv | Código GTIN del ítem, para la unidad de inventario. Antiguos códigos EAN, UPC y DUN-14 Informar campo vacío si el producto no posee este código. |
String | NO | N|1..9|0.6 | cantGTINComInv | Cantidad del producto o servicio en el Código GTIN del ítem de inventario. |
String | SI | N|2 | tasaITBMS | Tasa del ITBMS aplicable al ítem. 00:0% (exento) 01:7% 02:10% 03:15% |
String | SI | N|1..9|2.6 | valorITBMS | Monto del ITBMS del ítem. Producto de TasaITBMS y PrecioItem |
String | C/C | N|1..11|2.4 | tasaISC | Tasa del ISC aplicable al ítem. De acuerdo a la legislación vigente en el caso que aplique tasa porcentual. |
String | C/C | N|1..9|2.6 | valorISC | Monto del ISC del ítem. De acuerdo a la legislación vigente en el caso que aplique valor fijo o calculado. Producto de TasaISC y PrecioItem, en el caso que aplique tasa porcentual. |
<listaItemOTI> | ||||
List<oti> | ||||
String | C/C | N|2| | tasaOTI | Códigos: 01:SUME 911 02:Tasa Portabilidad Numérica 03: Impuesto sobre seguro (5%) 04: ATTT-Impuestos sobre seguro autos (1%) 05: Tasa Salida Aeropuerto (FZ) 06: Cargo Incentivo Desarrollo Aeropuerto (F3) 07: Cargo Seguridad Aeropuerto (AH) 08: Otros Cargos (XT) 09: Combustible (YQ) 10: FECI 11: Intereses |
String | C/C | N|1..9|2.6 | valorTasa | Valor de otra tasa o impuesto (OTI) |
Vehículo (Caso vehículo nuevo) | ||||
---|---|---|---|---|
Tipo | Requerido | Formato | Identificador | Descripción |
String | SI | AN|2 | modalidadOperacionVenta | 01:venta a representante. 02:venta al consumidor final. 03:venta a gobierno. 04:venta a flota de vehículos. 99:otros. |
String | C/C | AN|10..50 | modalidadOperacionVentaNoDef | Obligatorio si: ModalidadOperacionVenta = 99 |
String | SI | AN|17 | chasis | Código VIN. Chasis Vehículo. |
String | C/C | AN|1..4 | codigoColor | Color del vehículo. Código interno del fabricante. |
String | NO | AN|1..40 | colorNombre | Descripción del color del vehículo. Campo opcional. |
String | SI | N|1..4 | potenciaMotor | Potencia del motor (CV). |
String | C/C | N|1..4 | capacidadMotor | Expresada en litros. |
String | NO | N|1..11|0.4 | pesoNeto | Peso Neto en Toneladas. Campo opcional. |
String | NO | N|1..11|0.4 | pesoBruto | Suma de los valores recibidos. Suma de todas las ocurrencias de valorCuotaPagada. |
String | SI | N|2 | tipoCombustible | Peso Bruto en Toneladas. Campo opcional. |
String | C/C | AN|10..50 | tipoCombustibleNoDef | 01:gasolina. 02:diésel. 03:etanol. 08:eléctrico. 09:gasolina / eléctrico. 99:otro. |
String | SI | AN|1..21 | numeroMotor | Número del motor. |
String | NO | N|1..11|0.4 | capacidadTraccion | Capacidad máxima de tracción en Toneladas. Campo opcional. |
String | NO | N|1..11|0.4 | distanciaEjes | Distancia entre ejes en Metros. Campo opcional. |
String | C/C | N|4 | anoModelo | Año del modelo de fabricación. |
String | NO | N|4 | anoFabricacion | Año de fabricación. |
String | NO | N|1 | tipoPintura | 1: sólida. 2: metálica. 3: perla. 4: fosca. 9: otra. Campo opcional. |
String | C/C | AN|10..50 | tipoPinturaNodef | Obligatorio si TipoPintura = 9. |
String | SI | N|1 | tipoVehiculo | Utilizar tipos aceptados en el Registro Vehicular: 1: motocicleta 2: bus 3: camión 4: sedán 5: camioneta 6: pickup 7. Mini Pick-Up 8. Pick Up Grua 9. Pick Cabina Sencilla 10. Pick Up Cabina y Media 11. Pick- Up Doble Cabina 12. Sedan Híbrido 13. Microbus 14. Mini Bus 15. Mini Microbus 16. Busito 17. Hatcback 18. Mini Panel 19. Panel 20. Convertible 21. Coupe 22: Coupe Convertible 23. Mini Car 24. Motorscooter 25. Mototriciclo 26. Scooter 27. Triciclo 28. Limosina 29. Mini Vans 30. Van 31. Trailer 32. Semi Trailer 33. Suburvan 34. Vagon 35. Vagoneta 36. Remolque 37. Four Wheel 38.SUV |
String | SI | N|1 | usoVehiculo | Utilizar tabla del Departamento de Registro Vehicular: 1:comercial 2:particular 3:Diplomatica 4:Oficial 5:Especial |
String | C/C | N|1 | condicionVehiculo | 1:acabado. 2:semi-acabado. 3:inacabado. |
String | NO | N|1..3 | capacidadPasajeros | Capacidad máxima de pasajeros sentados. Campo opcional. |
Medicina (obligatorio si ítem es medicina o materia prima de medicina) | ||||
---|---|---|---|---|
Tipo | Requerido | Formato | Identificador | Descripción |
String | SI | AN|5..35 | nroLote | Número de lote de medicinas y materias primas farmacéuticas. |
String | SI | N|1..9 | cantProductosLote | Cantidad de productos en el lote de medicinas y materias primas farmacéuticas. |
TotalesSubTotales | ||||
---|---|---|---|---|
Tipo | Requerido | Formato | Identificador | Descripción |
String | SI | N|1..11|1.2 | totalPrecioNeto | Suma de los precios de ítems antes de aplicar impuestos.Suma de todas las ocurrencias de PrecioItem. |
String | SI | N|1..11|2 | totalITBMS | Suma de todas las ocurrencias de ValorITBMS. |
String | SI | N|1..11|2 | totalISC | Suma de todas las ocurrencias de ValorISC. |
String | SI | N|1..11|1.2 | totalMontoGravado | Suma total de monto gravado. Suma de TotalITBMS, TotalISC y valorTotalOTI. |
String | NO | N|1..11|1.2 | totalDescuento | Suma de los descuentos y bonificaciones concedidos sobre el valor total de la factura. Suma de todas las ocurrencias de montoDescuento. |
String | NO | N|1..11|1.2 | totalAcarreoCobrado | Valor del acarreo cobrado en el precio total. Si se informa, no se puede informar en el campo PrecioAcarreo. |
String | NO | N|1..11|1.2 | talorSeguroCobrado | Valor del seguro cobrado en el precio total. Si se informa, no se pueden informar en los campos PrecioSeguro. |
String | SI | N|1..11|1.2 | totalFactura | Valor total de la factura. La suma de TotalTodosItems, TotalAcarreoCobrado, ValorSeguroCobrado menos TotalDescuento. |
String | SI | N|1..11|1.2 | totalValorRecibido | Suma de los valores recibidos. Suma de todas las ocurrencias de valorCuotaPagada. |
String | C/C | N|1..11|1.2 | vuelto | Vuelto entregado al cliente (Diferencia entre TotalValorRecibido y TotalFactura). No informar el campo si no existe vuelto. |
String | SI | N|1 | tiempoPago | 1:Inmediato. 2:Plazo. 3:Mixto. |
String | SI | N|1..11 | nroItems | Número total de ítems contenidos en la factura u otro documento electrónico. |
String | SI | N|1..11|1.2 | totalTodosItems | Total de todos los Ítems (Suma de ValorTotal). |
DescuentoBonificacion (Opcional)) | ||||
---|---|---|---|---|
Tipo | Requerido | Formato | Identificador | Descripcion |
String | SI | AN|..500 | descDescuento | Descripción de descuentos o bonificaciones adicionales aplicadas a la factura. |
String | SI | N|1..11|2 | montoDescuento | Monto de los Descuentos/Bonificaciones y otros ajustes. |
List<formaPago> | ||||
---|---|---|---|---|
Tipo | Requerido | Formato | Identificador | Descripción |
String | SI | N|2 | formaPagoFact | 01:Crédito. 02:Efectivo. 03:Tarjeta Crédito. 04:Tarjeta Débito. 05:Tarjeta Fidelización. 06:Vale. 07:Tarjeta de Regalo. 08:Transf/Deposito cta. Bancaria 09: Cheque 99:Otro. |
String | C/C | AN|10..100 | descFormaPago | Descripción de forma de pago no listada en el formato. Obligatorio si: FormaPagoFact = 99. |
String | SI | N|1..11|1..2 | valorCuotaPagada | Valor de la cuota pagada utilizando esta forma de pago. |
retencion (cuando a la factura aplican retenciones) | ||||
---|---|---|---|---|
Tipo | Requerido | Formato | Identificador | Descripción |
String | SI | N|2 | codigoRetencion | Corresponde al catálogo de objetos de retención: 1:Pago por servicio profesional al estado 100%. 2:Pago por venta de bienes/servicios al estado 50%. 3:Pago o acreditación a no domiciliado o empresa constituida en el exterior 100%. 4:Pago o acreditación por compra de bienes/servicios 50%. 7:Pago a comercio afiliado a sistema de TC/TD 50%. 8:Otros (disminución de la retención). |
String | SI | N|1..11|1..2 | montoRetencion | Monto de la retención a aplicar. Debe corresponder al cálculo de la retención por el objeto de retención (TasaITBMS * TotalITBMS). |
List <pagoPlazo> (Opcional) | ||||
---|---|---|---|---|
Tipo | Requerido | Formato | Identificador | Descripción |
String | SI | AN|25 | fechaVenceCuota | Fecha de vencimiento de la cuota. |
String | SI | N|1..11|1..2 | valorCuota | Valor de la cuota. |
String | NO | AN|15..1000 | infoPagoCuota | Información de interés del emisor con respeto a esta cuota. |
listaTotalOTI | ||||
---|---|---|---|---|
List <totalOTI> | ||||
String | SI | N|2 | codigoTotalOTI | Códigos: 01:SUME 911 02:Tasa Portabilidad Numérica 03: Impuesto sobre seguro (5%) 04: ATTT-Impuestos sobre seguro autos (1%) 05: Tasa Salida Aeropuerto (FZ) 06: Cargo Incentivo Desarrollo Aeropuerto (F3) 07: Cargo Seguridad Aeropuerto (AH) 08: Otros Cargos (XT) 09: Combustible (YQ) 10: FECI 11: Intereses |
String | SI | N|1..11|1..2 | valorTotalOTI | La sumatoria de codigoTotalOTI para los ítems con el código igual a codigoTotalOTI |
pedidoComercialItem (Opcional) | ||||
---|---|---|---|---|
Tipo | Requerido | Formato | Identificador | Descripción |
String | SI | N|1..9 | nroPedidoCompraItem | Número del pedido de compra. |
String | SI | AN|1..3 | nroItem | Número secuencial del ítem en el pedido. |
String | NO | AB|0..5000 | infoItem | Información de interés del emisor con respeto al pedido comercial, relacionado con un ítem de la factura. |
pedidoComercialGlobal (opcional) | ||||
---|---|---|---|---|
Tipo | Requerido | Formato | Identificador | Descripción |
String | SI | AN|1..12 | nroPedidoCompraGlobal | Número del pedido de compra. |
String | C/C | AN|1..12 | codigoReceptor | Permite registrar el código con que el facturador identifica a su cliente o receptor de la factura |
String | C/C | AN|1..12 | nroAceptacion | Numero de aceptación de la lista de números de aceptación del pedido de compra |
String | C/C | A|1..50 | codigoSistemaEmisor | Permite registrar el código del sistema que emite la factura electrónica. |
String | C/C | AN|0..5000 | InfoPedido | Información de interés del emisor con respecto al Pedido Comercial global. |
ListaNroAceptacion (Opcional) | ||||
---|---|---|---|---|
Tipo | Requerido | Formato | Identificador | Descripción |
String | C/C | AN|1..12 | nroAceptacion | Número de aceptación del pedido de compra |
InfoLogistica | ||||
---|---|---|---|---|
Tipo | Requerido | Formato | Identificador | Descripción |
String | NO | N|1..3 | nroVolumenes | Número de volúmenes |
String | NO | N|1..4|2..6 | pesoCarga | Peso total de la carga. |
String | NO | N|1 | unidadPesoTotal | 1:g. 2:kg. 3:toneladas. 4:libras. |
String | NO | AN|6 | licVehiculoCarga | Licencia del vehículo de carga. |
String | SI | AN|15..100 | razonSocialTransportista | Nombre o Razón social del transportista. |
String | SI | N|1 | tipoRucTransportista | 1:Natural. 2:Jurídico. |
String | SI | AN|5..20 | rucTransportista | RUC del Transportista. |
String | SI | AN|2 | digitoVerifRucTransportista | Dígito Verificador RUC Transportista. Debe ser calculado en base al algoritmo del RUC publicado por la DGI. |
String | NO | AN|0..5000 | infoLogisticaEmisor | Información de interés del emisor con respeto a logística. |
InfoEntrega | ||||
---|---|---|---|---|
Tipo | Requerido | Formato | Identificador | Descripción |
String | SI | N|1 | tipoRucEntrega | Tipo de Contribuyente 1:Natural. 2:Jurídico. |
String | SI | AN|5..20 | numeroRucEntrega | RUC del receptor. |
String | SI | AN|2 | digitoVerifRucEntrega | Debe ser calculado en base al algoritmo del RUC publicado por la DGI. |
String | SI | An|2..100 | razonSocialEntrega | Razón Social (Persona Jurídica) o Nombre y Apellido (Persona Natural) del local de la entrega. |
String | SI | AN|100 | direccionEntrega | Urbanización, Calle, Casa/Edificio, Número de Local. Dirección del local de la entrega. |
String | SI | AN|8 | codigoUbicacionEntrega | Código compuesto de la ubicación. |
String | SI | AN|50 | corregimientoEntrega | Corregimiento donde se ubica el local de la entrega, según Catálogo. |
String | SI | AN|50 | distritoEntrega | Distrito donde se ubica el local de la entrega, según Catálogo. |
String | SI | AN|50 | provinciaEntrega | Provincia donde se ubica el local de la entrega, según Catálogo. |
String | SI | N|7..12 | telefonoEntrega | Teléfono de contacto del local de la entrega. Formatos aceptables 999-9999 ó 9999-9999 |
String | SI | N|7..12 | telefonoEntregaAlt | Teléfono de contacto adicional, o alterno del local de la entrega. Formatos aceptables 999-9999 ó 9999-9999 |
Ejemplo de XML
<soapenv:Body> <tem:Enviar> <tem:tokenEmpresa>SOLICITAR</tem:tokenEmpresa> <tem:tokenPassword>SOLICITAR</tem:tokenPassword> <tem:documento> <ser:codigoSucursalEmisor>0000</ser:codigoSucursalEmisor> <ser:tipoSucursal>1</ser:tipoSucursal> <ser:datosTransaccion> <ser:tipoEmision>01</ser:tipoEmision> <ser:tipoDocumento>01</ser:tipoDocumento> <ser:numeroDocumentoFiscal>176</ser:numeroDocumentoFiscal> <ser:puntoFacturacionFiscal>505</ser:puntoFacturacionFiscal> <ser:fechaEmision>2022-07-15T07:49:27-05:00</ser:fechaEmision> <ser:fechaSalida>2022-07-15T07:49:27-05:00</ser:fechaSalida> <ser:naturalezaOperacion>01</ser:naturalezaOperacion> <ser:tipoOperacion>1</ser:tipoOperacion> <ser:destinoOperacion>1</ser:destinoOperacion> <!--1: Panama 2: Extranjero--> <ser:formatoCAFE>1</ser:formatoCAFE> <ser:entregaCAFE>1</ser:entregaCAFE> <ser:envioContenedor>1</ser:envioContenedor> <ser:procesoGeneracion>1</ser:procesoGeneracion> <ser:tipoVenta>1</ser:tipoVenta> <ser:informacionInteres>Informacion Interes</ser:informacionInteres> <ser:cliente> <ser:tipoClienteFE>01</ser:tipoClienteFE> <!--iTipoREC--> <ser:tipoContribuyente>2</ser:tipoContribuyente> <ser:numeroRUC>155596713-2-2015</ser:numeroRUC> <ser:digitoVerificadorRUC>59</ser:digitoVerificadorRUC> <ser:razonSocial>Ambiente de pruebas</ser:razonSocial> <ser:direccion>Ave. La Paz</ser:direccion> <ser:codigoUbicacion>1-1-1</ser:codigoUbicacion> <ser:provincia>Bocas del Toro</ser:provincia> <ser:distrito>Bocas del Toro</ser:distrito> <ser:corregimiento>Bocas del Toro</ser:corregimiento> <ser:tipoIdentificacion></ser:tipoIdentificacion> <ser:nroIdentificacionExtranjero></ser:nroIdentificacionExtranjero> <ser:paisExtranjero></ser:paisExtranjero> <ser:telefono1>9999-9999</ser:telefono1> <ser:correoElectronico1>usuario@pruebas.com</ser:correoElectronico1> <ser:pais>PA</ser:pais> <ser:paisOtro/> </ser:cliente> </ser:datosTransaccion> <ser:listaItems> <ser:item> <ser:descripcion>Lapiz</ser:descripcion> <ser:codigo>CA-001</ser:codigo> <ser:unidadMedida>m</ser:unidadMedida> <ser:cantidad>1.00</ser:cantidad> <ser:fechaFabricacion>1999-05-10</ser:fechaFabricacion> <ser:fechaCaducidad>2019-05-10</ser:fechaCaducidad> <ser:unidadMedidaCPBS></ser:unidadMedidaCPBS> <ser:infoItem>Lapiz con Goma</ser:infoItem> <ser:precioUnitario>1234.12</ser:precioUnitario> <ser:precioUnitarioDescuento></ser:precioUnitarioDescuento> <ser:precioItem>1234.12</ser:precioItem> <ser:valorTotal>1335.3384</ser:valorTotal> <!--dvalTotItem--> <ser:codigoGTIN>0</ser:codigoGTIN> <ser:cantGTINCom>0.99</ser:cantGTINCom> <ser:codigoGTINInv>0</ser:codigoGTINInv> <ser:cantGTINComInv>1.00</ser:cantGTINComInv> <ser:tasaITBMS>01</ser:tasaITBMS> <ser:valorITBMS>86.3884</ser:valorITBMS> <ser:listaItemOTI> <ser:oti> <ser:tasaOTI>01</ser:tasaOTI> <ser:valorTasa>14.81</ser:valorTasa> </ser:oti> <ser:oti> <ser:tasaOTI>02</ser:tasaOTI> <ser:valorTasa>0.02</ser:valorTasa> </ser:oti> </ser:listaItemOTI> </ser:item> </ser:listaItems> <ser:totalesSubTotales> <ser:totalPrecioNeto>1234.12</ser:totalPrecioNeto> <ser:totalITBMS>86.39</ser:totalITBMS> <ser:totalMontoGravado>101.22</ser:totalMontoGravado> <ser:totalDescuento>0.00</ser:totalDescuento> <ser:totalAcarreoCobrado/> <ser:valorSeguroCobrado/> <ser:totalFactura>1335.34</ser:totalFactura> <ser:totalValorRecibido>1335.34</ser:totalValorRecibido> <ser:tiempoPago>1</ser:tiempoPago> <ser:nroItems>1</ser:nroItems> <ser:totalTodosItems>1335.34</ser:totalTodosItems> <ser:listaFormaPago> <ser:formaPago> <ser:formaPagoFact>02</ser:formaPagoFact> <ser:descFormaPago/> <ser:valorCuotaPagada>1335.34</ser:valorCuotaPagada> </ser:formaPago> </ser:listaFormaPago> <ser:listaTotalOTI> <ser:totalOti> <ser:codigoTotalOTI>01</ser:codigoTotalOTI> <ser:valorTotalOTI>14.81</ser:valorTotalOTI> </ser:totalOti> <ser:totalOti> <ser:codigoTotalOTI>02</ser:codigoTotalOTI> <ser:valorTotalOTI>0.02</ser:valorTotalOTI> </ser:totalOti> </ser:listaTotalOTI> </ser:totalesSubTotales> <ser:usoPosterior> <ser:cufe></ser:cufe> </ser:usoPosterior> </tem:documento> </tem:Enviar> </soapenv:Body>
EnviarResponse: Parámetros a recibir | ||
---|---|---|
Tipo | Identificador | Descripción |
String | codigo | Código correspondiente al resultado de la operación |
String | resultado | Indica el resultado del envió del documento |
String | mensaje | Mensaje adicional de la operación |
String | CUFE | Código Único de Factura Electrónica |
String | QR | Código QR de la Factura Electrónica |
String | fechaRecepcionDGI | Fecha de la autorización ante la DGI |
String | nroProtocoloAutorizacion | Número del protocolo de autorización ante la DGI |
Ejemplo de XML
<EnviarResponse xmlns="http://tempuri.org/"> <EnviarResult xmlns:a="http://schemas.datacontract.org/2004/07/Services.Response" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:codigo>200</a:codigo> <a:resultado>procesado</a:resultado> <a:mensaje>El documento se envió correctamente.</a:mensaje> <a:cufe>FE0120000155596713-2-2015-5900012019052800055000155650121566749040</a:cufe> <a:qr>https://dgi-fep-test.mef.gob.pa:40001/Consultas/FacturasPorQR?chFE=FE0120000155596713-2-2015-5900012019052800055000155650121566749040 &iAmb=2&digestValue=Y8oscJ8/WeLBXlEnXtIxn5SjXaAPQGlPdWAI0X0/OfU=&jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjaEZFIjoiRkUwMTIwMDAwMTU1NTk2N zEzLTItMjAxNS01OTAwMDEyMDE5MDUyODAwMDU1MDAwMTU1NjUwMTIxNTY2NzQ5MDQwIiwiaUFtYiI6IjIiLCJkaWdlc3RWYWx1ZSI6Ilk4b3NjSjgvV2VMQlhsRW5YdEl4bjVTalhhQVBRR2xQZFdBSTBYMC9PZlU9In0. iufLvrIWGBcxIBwbhvJuCmJWhs7pd8zl0wMt7mnS_zI</a:qr> <a:fechaRecepcionDGI>2019-05-29T13:32:21+00:00</a:fechaRecepcionDGI> <a:nroProtocoloAutorizacion>20190000000000179413</a:nroProtocoloAutorizacion> <a:fechaLimite i:nil="true"/> </EnviarResult> </EnviarResponse>