meta data de esta página
¡Esta es una revisión vieja del documento!
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 | CodigoSucursalEmsior | 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:ss 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 |
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. 10: Transferencia. 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 | SI | 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. |
String | SI | 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. |
String | NO | 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). |
String | C/C | AN|..100 | razonSocial | Obligatorio si TipoClienteFE = 01/03 (comprador contribuyente del ITBMS). |
String | C/C | AN|..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. |
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 |
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. |
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. |
String | SI | N|2 | tipoIdentificacion | Es Obligatorio sí tipoClienteFE = 04:Extranjero. 01:Pasaporte 02:Numero Tributario 99:Otro |
String | SI | AN|..50 | nroIdentificacionExtranjero | Número de Pasaporte o Número de Identificación Tributaria Extranjera. Es Obligatorio sí tipoClienteFE=04: Extranjero |
String | SI | 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 | 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)". |
String | C/C | AN|5..50 | paisOtro | Obligatorio si pais = ZZZ No puede existir si pais<> ZZ. |
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 | SI | AN|22 | NroFacturaPapel | Hace referencia al número de la factura en papel. |
String | NO | AN|22 | NroFacturaIF | Número de factura emitida por impresora fiscal |
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. |
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. |
String | NO | AN|1..30 | UnidadMedidaCPBS | Debe corresponder al catálogo de unidades de medida en Tabla 3. |
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 | SI | 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 |
String | SI | N|1..9|0.6 | CantGTINCom | Cantidad del producto o servicio en el Código GTIN del ítem de comercialización. |
String | SI | 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 | SI | 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. |
String | C/C | N|2| | tasaOTI | Códigos: 01:SUME 911 02:Tasa Portabilidad Numérica 03:Impuesto sobre seguro |
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. |
String | SI | N|1 | usoVehiculo | Utilizar tabla del Departamento de Registro Vehicular: 1:comercial. 2:particular. |
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 | N|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 y TotalISC. |
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 | ValorSeguroCobrado | 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:Contado. 03:Tarjeta Crédito. 04:Tarjeta Débito. 05:Tarjeta Fidelización. 06:Vale. 07:Tarjeta de Regalo. 08:Transf/Deposito cta. Bancaria 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. |
Retención (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. |
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 | N|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>2019-05-15T07:49:27-05:00</ser:fechaEmision> <ser:fechaSalida>2019-05-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>02</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:totalISC>0.00</ser:totalISC> <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>